Skip to main content
The CabalSpy MCP server gives AI assistants live access to labeled wallet data. It exposes the v1 API and CabalSpy ID as 38 read-only tools, so an assistant can look up a wallet, see what KOLs are buying, check token holders, read cluster signals, look up our curated calls and how they performed, detect bundled launches, check who owns a wallet and read what verified holders think about a token, 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. Get a free key in the API Dashboard.

Try it without a key

Connect to https://mcp.cabalspy.xyz/mcp with no key and every tool still works, on the public demo: 20 requests per IP per day, data delayed 15 minutes, at most 5 rows per list. Demo results carry a demo block, and the assistant is told the data is not live. When the 20 requests are used up, tools return demo_limit_reached with the link to a free key.
Claude Code, no key

Connect

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?
  • What did CabalSpy call today, and how did the calls do?
  • Was this token launch bundled?
  • Who is still holding this token and who already sold?
  • What do verified holders think about $BONK?
  • Who owns this wallet?
  • Is @handle a verified trader, and which wallets does he use?

Tools

Results for a single Solana token include a trade_url, the token page in the CabalSpy Terminal.

CabalSpy ID tools

CabalSpy ID is the SocialFi layer for trading platforms: traders sign in, verify their wallets with an on-chain payment, and their trades feed profiles, KOL badges, leaderboards and token theses. The csid_ tools bring that into the assistant. The identity tools call /v1/csid/* on the CabalSpy API (api.cabalspy.xyz). Without a key they answer from sandbox identities only (marked sandbox: true), so the demo never shows real people. The theses and leaderboard tools call the CabalSpy ID Data API with the same key. That key needs CabalSpy ID enabled and a CabalSpy ID instance on its account: create one in the dashboard (free plan available). Otherwise the tools return csid_setup_required, no_instance or product_not_enabled with that link. Theses are global for every plan; the leaderboard covers your instance’s users. If your account has several instances, pass instance (the client_id) or send an X-CSID-Instance header with the connection. All csid_ tools are read-only. Posting theses on behalf of a user is not part of the MCP server; platforms do that through the Theses API.

Coverage

Solana has KOL, Smart Money and Whale wallets. BNB Chain, Base, Ethereum and Robinhood Chain (rh) have KOL and Smart Money. 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. Without a key, tool calls count against the demo’s 20 requests per IP per day instead.