shout-run-mcp 0.1.0

MCP server for shout.run — live terminal broadcasting for AI agents

shout-run-mcp

MCP server for shout.run — live terminal broadcasting for AI agents.

Let your AI agents broadcast terminal output so humans can watch in real-time.

Install

pip install shout-run-mcp

Or run directly with uvx:

uvx shout-run-mcp

Setup

Get an API key at shout.run, 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

Tool	Description
shout_start_broadcast	Start broadcasting — creates a session and returns the viewer URL
shout_write	Send terminal output to the broadcast (supports ANSI codes)
shout_end_broadcast	End the active broadcast
shout_broadcast_status	Check session state, viewer count, and duration

Environment Variables

Variable	Required	Description
SHOUT_API_KEY	Yes	Your shout.run API key
SHOUT_API_URL	No	API base URL (default: https://api.shout.run)

License

MIT