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

# MCP Server

> Connect Claude, Cursor, VS Code and other AI clients to CabalSpy wallet data. Remote MCP server with 21 read-only tools for KOL, Smart Money and Whale wallets.

The CabalSpy MCP server gives AI assistants live access to labeled wallet data. It exposes the v1 API as 21 read-only tools, so an assistant can look up a wallet, see what KOLs are buying, check token holders, read cluster signals and detect bundled launches, and answer in plain language.

It is a remote server. There is nothing to install or run, and it never signs transactions or touches funds.

| | |
| - | - |
| Server URL | `https://mcp.cabalspy.xyz/mcp` |
| Transport | Streamable HTTP |
| Auth | Header `X-CabalSpy-Key: YOUR_KEY`, or `?api_key=YOUR_KEY` on the URL |
| Source | [CabalSpy/CabalSpy-MCP-Server](https://github.com/CabalSpy/CabalSpy-MCP-Server) |

Get a free key in the [API Dashboard](https://apidashboard.cabalspy.xyz/register).

## Connect

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http cabalspy https://mcp.cabalspy.xyz/mcp \
    --header "X-CabalSpy-Key: YOUR_KEY"
  ```

  ```json Cursor (~/.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "cabalspy": {
        "url": "https://mcp.cabalspy.xyz/mcp",
        "headers": { "X-CabalSpy-Key": "YOUR_KEY" }
      }
    }
  }
  ```

  ```json VS Code (.vscode/mcp.json) theme={null}
  {
    "servers": {
      "cabalspy": {
        "type": "http",
        "url": "https://mcp.cabalspy.xyz/mcp",
        "headers": { "X-CabalSpy-Key": "YOUR_KEY" }
      }
    }
  }
  ```

  ```text URL only (claude.ai connectors) theme={null}
  https://mcp.cabalspy.xyz/mcp?api_key=YOUR_KEY
  ```
</CodeGroup>

Where a client lets you set headers, prefer the header. It keeps the key out of logs.

## Things to ask

* Who are the best performing Solana KOLs this week?
* What are KOLs buying right now?
* Was this token launch bundled?
* Who is still holding this token and who already sold?

## Tools

| Group | Tools |
| - | - |
| Wallets | `list_wallets`, `lookup_wallet`, `get_leaderboard`, `get_wallet_tracker`, `get_wallet_holdings`, `get_wallet_history`, `get_pnl_calendar`, `get_wallet_connections`, `compare_wallets` |
| Tokens | `get_token_stats`, `get_token_holders`, `get_token_transactions`, `detect_bundles`, `compare_tokens` |
| Feed and signals | `get_recent_trades`, `get_signals`, `get_signal_history`, `get_activity_metrics`, `get_analytics` |
| Service | `get_api_status`, `get_started` |

Results for a single Solana token include a `trade_url`, the token page in the [CabalSpy Terminal](https://app.cabalspy.xyz/).

## Coverage

Solana has KOL, Smart Money and Whale wallets. BNB Chain, Base and Robinhood Chain (`rh`) have KOL and Smart Money. Ethereum has KOL. Market cap and price in USD are returned for Solana tokens only.

## Credits

The server uses your API key, so tool calls count against your plan like REST requests. See [Pricing](/pricing).


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