API DOCS

MCP server for whale data free, no key

Free Model Context Protocol server for Ethereum whale data at deepbluealpha.io/mcp: 7 read-only tools for AI agents. Streamable HTTP, no auth, 120 calls per 10 minutes. Setup and tools.

Home › API docs › MCP server (AI agents) · Updated 2026-10-26

https://deepbluealpha.io/mcp is a free Model Context Protocol server (Streamable HTTP, stateless, no auth) that gives AI assistants and agents — Claude, ChatGPT, Cursor and any MCP client — seven read-only tools over Deep Blue Alpha’s free Ethereum whale data. It is listed in the official MCP Registry as io.deepbluealpha/whale-data.

Endpoints

POST/mcp (JSON-RPC 2.0, Streamable HTTP)
GET/mcp (setup page in a browser)

Base URL https://deepbluealpha.io · JSON over HTTPS · Ethereum mainnet only.

Authentication
None.
Rate limit
120 tool calls per 10 minutes per IP address.
Plan & license
Free. Answers are CC BY 4.0 with attribution “Deep Blue Alpha (deepbluealpha.io)”.

Tools

ToolKindArgumentsReturns
get_token_whale_activitytoolsymbol, timeframe 24h|7d|30dOne token: withdrawn from / deposited to exchanges, DEX swaps, net flow, wallets, largest move.
get_top_whale_tokenstooltimeframe 1h|24h, limit ≤10Tokens with the most tracked whale volume.
get_exchange_flow_leaderstooldirection withdrawn|deposited, timeframe 24h|7dLargest net flow off or onto exchanges.
get_recent_whale_movestoollimit ≤15, symbol, min_usd (100000)Latest labeled whale moves.
get_whale_sentiment_indextool—Today’s index, components and the last 7 days.
get_daily_whale_reporttool—Latest daily whale report summary.
get_platform_statstool—Coverage and 24h exchange-flow totals.

Example request (curl)

curl -s https://deepbluealpha.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_token_whale_activity",
                 "arguments":{"symbol":"LINK","timeframe":"7d"}}}'

# Claude Code
claude mcp add --transport http deep-blue-alpha https://deepbluealpha.io/mcp

Python example

import requests

URL = "https://deepbluealpha.io/mcp"
HDR = {"Content-Type": "application/json", "Accept": "application/json, text/event-stream"}

def call(method, params=None, id_=1):
    r = requests.post(URL, headers=HDR, timeout=30,
                      json={"jsonrpc": "2.0", "id": id_, "method": method, "params": params or {}})
    r.raise_for_status()
    return r.json()["result"]

tools = call("tools/list")["tools"]
print([t["name"] for t in tools])
res = call("tools/call", {"name": "get_recent_whale_moves",
                          "arguments": {"limit": 5, "min_usd": 250000}})
print(res["content"][0]["text"])

Sample response EXAMPLE VALUES

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [ { "type": "text", "text": "LINK — tracked whale moves, last 7 days ..." } ],
    "structuredContent": { "...": "the same data as JSON" },
    "isError": false
  }
}

Field names and structure are the real ones; the numbers, hashes and addresses are placeholders, not live data.

Fields

FieldMeaning
content[0].textA readable summary that ends with a not-financial-advice line and attribution.
structuredContentThe same data as JSON, when the tool returns structured data.
isErrortrue with a message on errors, including the rate limit.

Notes and limits

Errors

FAQ

Is there an MCP server for Ethereum whale data?

Yes. https://deepbluealpha.io/mcp is a free, no-key MCP server (Streamable HTTP) with 7 read-only tools for Ethereum whale moves, exchange flows, top whale tokens and the Whale Sentiment Index. Rate limit: 120 calls per 10 minutes per IP.

More endpoint docs

Guides: best Ethereum whale tracking APIs compared · real-time whale tracking for a trading bot · whale webhook APIs · methodology · OpenAPI 3.0 spec · Business plan

Not financial advice. Deep Blue Alpha data describes what tracked wallets did on-chain. It does not predict prices and is not a trading recommendation. Labels are heuristics from known address lists; see the methodology. Facts on this page checked 2026-10-26.