MCP

The Rad TV API exposes a Model Context Protocol (MCP) server so IDEs and coding agents (e.g. Cursor, Claude) can interact with the API using tools with typed inputs.

Endpoint

• URL: POST /mcp (and GET /mcp, DELETE /mcp for Streamable HTTP)
• Auth: Required. Send Authorization: Bearer <api-key>. Use an API key from POST /internal/v0/generate-api-key (see API keys).
• Production: https://api.rad.live/mcp.

What MCP provides

• 23 tools — Map to core API actions: identity, channels, categories, ratings, genres, content, playlists, ingestion, engagement, YouTube. Each tool has a description and an input schema.
• 1 resource — rad://api/capabilities returns JSON with name, version, tools (list of names), llms_txt, graphql, and description.
• 2 prompts — create_content_and_upload (guide for content + TUS upload), follow_a_channel (guide to follow by DID).

Protocol

Step 1: Initialize

Send an initialize JSON-RPC request first (required).

Step 2: List tools

Use tools/list to get all tools and their schemas.

Step 3: Call tools

Use tools/call with name and arguments.

Step 4: Resources

Read rad://api/capabilities for a summary of capabilities.

When to use MCP vs GraphQL