MCP server for shout.run. Terminal broadcasting for AI agents.

Works with Claude Code, Cursor, Windsurf, and other MCP clients. Agents broadcast and viewers watch in a browser.

Setup

Claude Code

Add to your Claude Code settings (.claude/settings.json):

{
  "mcpServers": {
    "shout": {
      "command": "npx",
      "args": ["-y", "shout-run-mcp"],
      "env": {
        "SHOUT_API_KEY": "shout_sk_..."
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "shout": {
      "command": "npx",
      "args": ["-y", "shout-run-mcp"],
      "env": {
        "SHOUT_API_KEY": "shout_sk_..."
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | shout_start_broadcast | Start a live broadcast (returns viewer URL) | | shout_write | Send terminal output to viewers | | shout_end_broadcast | End the active broadcast | | shout_broadcast_status | Check broadcast status and viewer count | | shout_delete_session | Delete an ended session you own (permanent) | | shout_search_sessions | Search sessions by query, tags, and status | | shout_read_session | Read the plain-text transcript of a session |

Getting an API Key

npm install -g shout-run
shout login
shout api-key create "My MCP Server"

The key is printed once. Save it somewhere safe. Keys start with shout_sk_.

You can list your keys with shout api-key list and revoke one with shout api-key revoke <id>.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SHOUT_API_KEY | Yes | — | API key (starts with shout_sk_) | | SHOUT_API_URL | No | https://api.shout.run | API base URL |

License

MIT