shout-run-mcp

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

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

Install

pip install shout-run-mcp

Or run directly with uvx:

uvx shout-run-mcp

Setup

Get an API key with the CLI:

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_.

Then configure your MCP client.

Claude Code

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

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

Cursor

Add to .cursor/mcp.json:

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

With pip install

If you installed via pip instead of using uvx:

{
  "mcpServers": {
    "shout": {
      "command": "shout-mcp",
      "env": {
        "SHOUT_API_KEY": "shout_sk_..."
      }
    }
  }
}

Tools

Environment Variables

License

MIT