MCP Server — KOL data
for your AI agent

The CabalSpy MCP server gives Claude, Cursor, VS Code and other AI clients live access to labeled KOL, Smart Money and Whale wallets: who is buying what, who is still holding, and whether a launch was bundled. 21 read-only tools, one URL, no install.

3,000+
Labeled Wallets
1.5M+
Wallet TXN / month
10M+
API Requests / month
20+
Integration Partners
99.90%
Uptime SLA
Trusted by
Axiom
MevX
XTrade
Mizar
Trojan
Trady
o1.exchange
Glyde
Genius
Axiom
MevX
XTrade
Mizar
Trojan
Trady
o1.exchange
Glyde
Genius
Model Context Protocol · Remote Server

Ask your AI assistant what KOLs are buying

What it does

The Model Context Protocol (MCP) lets AI assistants call external tools. The CabalSpy MCP server exposes the CabalSpy KOL and Smart Money API as 21 tools an assistant can use on its own: it picks the right tool, fills in the parameters and answers in plain language, with real on-chain data instead of guesses.

It is a remote server — nothing to download or run. All tools are read-only: the server returns data and never signs transactions or touches funds.

Connect in one minute

Get a free key from the API dashboard (10,000 credits per month, no credit card) and replace YOUR_KEY below.

Server URLhttps://mcp.cabalspy.xyz/mcp
TransportStreamable HTTP
AuthHeader X-CabalSpy-Key: YOUR_KEY, or ?api_key=YOUR_KEY on the URL

Claude Code

Terminal
claude mcp add --transport http cabalspy https://mcp.cabalspy.xyz/mcp \
  --header "X-CabalSpy-Key: YOUR_KEY"

Cursor

Use the Add to Cursor button, or add this to ~/.cursor/mcp.json:

~/.cursor/mcp.json
{
  "mcpServers": {
    "cabalspy": {
      "url": "https://mcp.cabalspy.xyz/mcp",
      "headers": { "X-CabalSpy-Key": "YOUR_KEY" }
    }
  }
}

VS Code

Use the Add to VS Code button, or add this to .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "cabalspy": {
      "type": "http",
      "url": "https://mcp.cabalspy.xyz/mcp",
      "headers": { "X-CabalSpy-Key": "YOUR_KEY" }
    }
  }
}

Claude Desktop, claude.ai and other clients

Clients that only take a URL (for example custom connectors in claude.ai) can pass the key as a query parameter:

Connector URL
https://mcp.cabalspy.xyz/mcp?api_key=YOUR_KEY

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? <mint address>
  • Who is still holding this token and who already sold?
  • Which Smart Money wallets entered the same token in the last 6 hours?
  • Is this wallet a tracked KOL? <address>

All 21 tools

Wallets

list_walletsBrowse the KOL, Smart Money or Whale wallets tracked on a chain.
lookup_walletIdentify an address: is it tracked, and under which name, X and Telegram.
get_leaderboardTop wallets by performance for a chain, wallet type and period.
get_wallet_trackerPeriod stats for one wallet: realized PnL, win rate, volume, trades.
get_wallet_holdingsCurrent on-chain token holdings of a wallet, read live.
get_wallet_historyLifetime trading history with per-token overview and trades.
get_pnl_calendarDaily and monthly realized PnL, for spotting streaks.
get_wallet_connectionsWallets that traded the same tokens — groups that move together.
compare_walletsStatistics for up to 100 wallets in one request.

Tokens

get_token_statsWho is trading a token: KOL, Smart Money and Whale counts, buying pressure, positions.
get_token_holdersTracked wallets still holding a token, sorted by balance.
get_token_transactionsIndividual buys and sells by tracked wallets in one token.
detect_bundlesWas a Solana launch bundled? KOL bundles with confidence score and evidence.
compare_tokensStatistics for up to 100 tokens in one request.

Market feed and signals

get_recent_tradesThe live feed: what tracked wallets are buying and selling right now.
get_signalsTokens where several tracked wallets acted in the same window (cluster, entry, exit).
get_signal_historyPast signals, to check how a kind of signal worked historically.
get_activity_metricsTrade count, volume and distinct wallets over a window of up to 24 hours.
get_analyticsAggregate views: volume trend, most traded tokens, win rates, top performers.

Service

get_api_statusHealth, supported chains and how many wallets are tracked per chain.
get_startedHow to get a free API key, pricing, docs and data caveats.

Coverage

Solana has KOL, Smart Money and Whale wallets; BNB Chain, Base and Robinhood Chain have KOL and Smart Money; Ethereum has KOL wallets — 3,000+ labeled wallets in total. Statistics are available for 6 hours, 1 day, 7 days and 30 days. Market cap and price in USD are returned for Solana tokens.

Who uses it

  • Traders — research a token or a wallet in a chat instead of five dashboards
  • AI agent builders — give a trading or research agent a labeled-wallet data source without writing API glue
  • Developers — explore the API from the editor before integrating the REST and WebSocket API
  • Analysts — check whether a launch was bundled or which wallets move together

Found a token worth trading? Open it in the CabalSpy Terminal.

Frequently asked questions

01

What is the CabalSpy MCP server?

The CabalSpy MCP server connects AI assistants such as Claude, Cursor, VS Code Copilot and ChatGPT to CabalSpy's labeled wallet data. Through 21 read-only tools the assistant can look up KOL, Smart Money and Whale wallets, see what they are buying right now, check token holders, detect bundled launches and read cluster signals on Solana, BNB Chain, Base, Ethereum and Robinhood Chain.

02

How do I connect the CabalSpy MCP server?

Add the remote server URL https://mcp.cabalspy.xyz/mcp to your MCP client and pass your CabalSpy API key in the X-CabalSpy-Key header. Clients that cannot send custom headers, such as claude.ai connectors, can append the key to the URL as ?api_key=YOUR_KEY instead. No local installation is needed.

03

Is the CabalSpy MCP server free?

The server itself is free to connect. It uses your CabalSpy API key, and the free tier includes 10,000 credits per month (1,000 requests) with no credit card. Paid plans start at $49/month.

04

Can the MCP server trade or move funds?

No. Every tool is read-only: the server only returns data about tracked wallets, tokens, trades and signals. It never holds keys, signs transactions or places trades.

05

Which chains and wallet types does it cover?

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

06

Which AI clients work with it?

Any client that supports remote MCP servers over Streamable HTTP, including Claude Code, Claude Desktop and claude.ai connectors, Cursor, VS Code, Windsurf and ChatGPT developer mode.

Related

Give your AI real wallet data. Free API key, no credit card.

10,000 free credits every month. One URL, 21 read-only tools, five chains.