@wave-av/mcp-server

MCP (Model Context Protocol) server that exposes WAVE streaming APIs as tools for AI coding assistants.

Quick start

npx @wave-av/mcp-server

Setup

1. Get an API key

# Via CLI
wave auth login

# Or create at https://wave.online/settings/api-keys

2. Configure your AI tool

Add to your .mcp.json (Claude Code, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "wave": {
      "command": "npx",
      "args": ["-y", "@wave-av/mcp-server"],
      "env": {
        "WAVE_API_KEY": "wave_live_..."
      }
    }
  }
}

Available tools

Streams

Tool	Description
`wave_list_streams`	List all streams with pagination and status filtering
`wave_create_stream`	Create a new stream with protocol and privacy options
`wave_start_stream`	Start streaming on an existing stream
`wave_stop_stream`	Stop an active stream
`wave_get_stream_health`	Get real-time health metrics for a stream

Studio

Tool	Description
`wave_list_productions`	List studio production sessions
`wave_create_production`	Create a new multi-camera production

Analytics

Tool	Description
`wave_get_viewers`	Get current viewer count and breakdown
`wave_get_stream_metrics`	Get detailed stream performance metrics

Billing

Tool	Description
`wave_get_subscription`	Get current subscription plan and status
`wave_get_usage`	Get current period usage and limits

Resources

Access WAVE entities directly via the wave:// URI scheme:

wave://streams/{id} - Stream configuration and status
wave://productions/{id} - Studio production details

Environment variables

Variable	Required	Default	Description
`WAVE_API_KEY`	Yes	-	Your WAVE API key
`WAVE_BASE_URL`	No	`https://wave.online`	API base URL

Setup for other AI tools

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "wave": {
      "command": "npx",
      "args": ["-y", "@wave-av/mcp-server"],
      "env": { "WAVE_API_KEY": "wave_live_..." }
    }
  }
}

Windsurf

Add to Windsurf MCP settings with the same configuration.

Troubleshooting

Server not starting

Verify your API key is set:

echo $WAVE_API_KEY

Tools not appearing

Restart your AI tool after adding the MCP configuration. Most tools require a restart to detect new MCP servers.

Connection errors

The MCP server uses stdio transport (no network listener). If you see connection errors, check that npx can run successfully:

npx @wave-av/mcp-server --version

Testing the server

Send a JSON-RPC initialize request to verify:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx @wave-av/mcp-server

Related packages

@wave-av/sdk — TypeScript SDK (34 API modules)
@wave-av/adk — Agent Developer Kit
@wave-av/cli — Command-line interface
@wave-av/create-app — Scaffold a new project
OpenAPI spec — Full API specification

Development

cd packages/mcp-server
pnpm install
pnpm run build
pnpm run dev       # Watch mode
pnpm run type-check

License

MIT

WAVE MCP Server