> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therundown.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentation MCP

> Connect TheRundown API docs to Codex, Claude, Cursor, and other AI assistants.

TheRundown provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that lets AI assistants search our documentation directly. Ask questions about endpoints, query parameters, response fields, market IDs, billing headers, and integration patterns without leaving your editor.

<Info>
  This MCP server is **documentation-only**. It helps your assistant understand the API, but it does not stream live sports data or make authenticated API calls on your behalf. For live data, your agent still needs to call the real API using your own TheRundown key.
</Info>

For authenticated sports and odds tools, use the separate [data MCP](/data-mcp) with your own API key, hosted or local. The hosted, authenticated Streamable HTTP endpoint at `https://mcp.therundown.io/mcp` needs no install; the [official public source repository](https://github.com/TheRundown/data-mcp) and its versioned 0.2.3 source bundle run the local stdio server instead. Both expose the same six titled read-only tools — `list_sports`, `list_affiliates`, `list_markets`, `list_events`, `get_main_lines`, and `list_futures` — plus the `therundown://brief` resource carrying its scoped-data rules and first conversation. Initialization, metadata listings, and the exact brief read are keyless and do not call Product data; the six Product tools still require your key. Either way it is separate from this documentation server, which does not gain live-data tools when you install it. See the [data MCP guide](/data-mcp#hosted-endpoint) for auth headers and setup.

## Server URL

```
https://docs.therundown.io/mcp
```

## Codex

Add the documentation server from your terminal:

```bash theme={null}
codex mcp add therundown-docs --url https://docs.therundown.io/mcp
```

This server searches TheRundown documentation only. It does not call the Product API or return live sports data. See [OpenAI's Codex MCP documentation](https://developers.openai.com/codex/mcp) for client configuration details.

## Claude Code

Add the server from your terminal:

```bash theme={null}
claude mcp add --transport http therundown https://docs.therundown.io/mcp
```

## Cursor

Open the command palette and search "Open MCP settings", then add to your `mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "therundown": {
      "url": "https://docs.therundown.io/mcp"
    }
  }
}
```

## VS Code

Create or update `.vscode/mcp.json` in your project:

```json theme={null}
{
  "servers": {
    "therundown": {
      "type": "http",
      "url": "https://docs.therundown.io/mcp"
    }
  }
}
```

## Claude Desktop

Add this to your Claude Desktop config file:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "therundown": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.therundown.io/mcp"
      ]
    }
  }
}
```

Restart Claude Desktop after saving.

## Windsurf

Add to your `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "therundown": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.therundown.io/mcp"
      ]
    }
  }
}
```

## What you can ask

### Connect the data MCP before a data request

The documentation MCP cannot execute Product API requests. First connect the [data MCP](/data-mcp) with your own API key: the [hosted endpoint](/data-mcp#hosted-endpoint) needs no install, or run the local stdio server. Then use this conversation with the data MCP:

```text theme={null}
Use TheRundown to list current sports and affiliates. Find MLB (sport 3).
For today's UTC date, list events with market_ids [1,2,3]
and affiliate_ids [19,23]. Select an event ID from that response and
call get_main_lines with the same filters.
Show the source URL, each book's line value and price updated_at,
and the returned usage headers. Explain empty results without inventing odds.
```

The best workflow is:

1. Ask MCP which endpoint, filters, and market IDs you need
2. Ask it for a code example in your language
3. Have your agent call the real API with your own key
4. Use the returned billing headers to keep usage under control

Once connected, you can ask your AI assistant questions like:

* "What is the cheapest way to monitor NBA moneyline, spread, and total on DraftKings and FanDuel?"
* "Should I use market delta or WebSocket for live line movement?"
* "What headers tell me remaining data points on my key?"
* "What are the market IDs for player props in NBA?"
* "Show me a Python example for `GET /api/v2/sports/{sportID}/events/{date}` with `market_ids` and `affiliate_ids` filters"
* "What does the `0.0001` sentinel value mean and how should I handle it?"

The MCP server searches across the API reference, guides, SDK docs, and reference tables to find relevant answers and examples.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.