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.


















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 URL | https://mcp.cabalspy.xyz/mcp |
| Transport | Streamable HTTP |
| Auth | Header X-CabalSpy-Key: YOUR_KEY, or ?api_key=YOUR_KEY on the URL |
Claude Code
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:
{
"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:
{
"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:
https://mcp.cabalspy.xyz/mcp?api_key=YOUR_KEYWhere 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_wallets | Browse the KOL, Smart Money or Whale wallets tracked on a chain. |
lookup_wallet | Identify an address: is it tracked, and under which name, X and Telegram. |
get_leaderboard | Top wallets by performance for a chain, wallet type and period. |
get_wallet_tracker | Period stats for one wallet: realized PnL, win rate, volume, trades. |
get_wallet_holdings | Current on-chain token holdings of a wallet, read live. |
get_wallet_history | Lifetime trading history with per-token overview and trades. |
get_pnl_calendar | Daily and monthly realized PnL, for spotting streaks. |
get_wallet_connections | Wallets that traded the same tokens — groups that move together. |
compare_wallets | Statistics for up to 100 wallets in one request. |
Tokens
get_token_stats | Who is trading a token: KOL, Smart Money and Whale counts, buying pressure, positions. |
get_token_holders | Tracked wallets still holding a token, sorted by balance. |
get_token_transactions | Individual buys and sells by tracked wallets in one token. |
detect_bundles | Was a Solana launch bundled? KOL bundles with confidence score and evidence. |
compare_tokens | Statistics for up to 100 tokens in one request. |
Market feed and signals
get_recent_trades | The live feed: what tracked wallets are buying and selling right now. |
get_signals | Tokens where several tracked wallets acted in the same window (cluster, entry, exit). |
get_signal_history | Past signals, to check how a kind of signal worked historically. |
get_activity_metrics | Trade count, volume and distinct wallets over a window of up to 24 hours. |
get_analytics | Aggregate views: volume trend, most traded tokens, win rates, top performers. |
Service
get_api_status | Health, supported chains and how many wallets are tracked per chain. |
get_started | How 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
01What 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.
02How 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.
03Is 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.
04Can 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.
05Which 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.
06Which 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.
