Boomstream MCP Server v0.7.1

npm: @boomstream/mcp boomstream.com

105 tools covering Boomstream media, live, ppv, conference, folder, playlist, stats, chat, screenshots, subtitles, timecodes, webhooks, project, record-live, and more — via Model Context Protocol.

Connection

Auth: Authorization: Bearer <apikey> (HTTP header, required)
Transport: SSE (Server-Sent Events)
SSE endpoint: https://mcp.boomstream.com/sse
Messages: POST https://mcp.boomstream.com/messages/?sessionId=<id>
Get API key: Boomstream account → Settings → Integration → API key

Quick start

Claude Code CLI

claude mcp add --transport sse boomstream https://mcp.boomstream.com/sse \
  --header "Authorization: Bearer <YOUR_APIKEY>"
claude mcp list  # expect: boomstream ✓ Connected

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "boomstream": {
      "transport": "sse",
      "url": "https://mcp.boomstream.com/sse",
      "headers": {
        "Authorization": "Bearer <YOUR_APIKEY>"
      }
    }
  }
}

MCP SDK (Node.js)

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js'

const transport = new SSEClientTransport(
  new URL('https://mcp.boomstream.com/sse'),
  { requestInit: { headers: { Authorization: `Bearer ${apikey}` } } }
)
const client = new Client({ name: 'my-app', version: '0.1' }, { capabilities: {} })
await client.connect(transport)

claude.ai web (Connectors)

Not yet supported — claude.ai web custom-connector UI requires OAuth Client ID/Secret, not a Bearer header. Planned for Phase B (OAuth).

Tool catalog

105 tools, 28 resource families:

Section	Tools
`ppv`	13
`live`	8
`media`	7
`cameraLive`	7
`playlist`	7
`conference`	6
`subtitles`	6
`webhook`	6
`app`	5
`conference_client`	4
`recordLive`	4
`screenshot`	4
`timecodes`	4
`media_folder`	3
`live_folder`	3
`materials_folder`	3
`stats`	3
`chat`	2
`chat_create`	1
`chat_update`	1
`chat_delete`	1
`materials`	1
`general`	1
`recordLive_create_record`	1
`recordLive_upcoming`	1
`recordLive_start_upcoming`	1
`recordLive_stop_upcoming`	1
`recordLive_remove_upcoming`	1

Full schema: the tools/list MCP method returns all 105 tools with input schemas.

HTTP endpoints

Path	Method	Auth	Purpose
`/`	GET	none	This landing page
`/sse`	GET	Bearer	SSE event stream + session establishment
`/messages/?sessionId=<id>`	POST	Bearer	JSON-RPC message channel
`/health`	GET	none	Health check — returns `{"status":"ok"}`

Rate limits

Per-IP (ingress): 120 req/min, 20 concurrent connections
Per-session (pod): 120 req/min sustained, 40 burst → HTTP 429 + Retry-After on exhaust

Session lifecycle

Sessions are in-memory per pod. Pod-to-pod forwarding handles cross-pod routing. Session idle timeout: 30 minutes. SSE stream auto-closes after timeout — reconnect to establish a new session.

Architecture

Phase A: shared apikey per Bearer — per-user OAuth = Phase B (planned)
npm: @boomstream/mcp (matching version)

License

MIT