On-chain Bitcoin & Ethereum forensics for AI assistants

Add to claude_desktop_config.json (or settings.json on newer plugin-aware versions):

{
  "mcpServers": {
    "swiss-whale": {
      "url": "https://mcp.btcwhalealerts.com/mcp",
      "transport": "streamable-http"
    }
  }
}

File location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Quit Claude Desktop completely (System Tray → Quit), then relaunch.

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "swiss-whale": {
      "url": "https://mcp.btcwhalealerts.com/mcp"
    }
  }
}

Cursor reloads MCP config automatically; if not, restart Cursor.

Add to ~/.continue/config.json under experimental.modelContextProtocolServers:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "swiss-whale",
        "transport": {
          "type": "streamable-http",
          "url": "https://mcp.btcwhalealerts.com/mcp"
        }
      }
    ]
  }
}

Add to Zed's settings.json under context_servers:

{
  "context_servers": {
    "swiss-whale": {
      "command": {
        "path": "npx",
        "args": ["mcp-remote", "https://mcp.btcwhalealerts.com/mcp"]
      }
    }
  }
}

mcp-remote wraps our HTTP transport for stdio-only clients.

Direct JSON-RPC 2.0 over HTTP. Anonymous Free-tier:

# 1. Initialize a session
curl -i -X POST https://mcp.btcwhalealerts.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18",
                 "capabilities":{},
                 "clientInfo":{"name":"curl","version":"1"}}}'
# Capture mcp-session-id from the response headers.

# 2. Acknowledge initialization
curl -X POST https://mcp.btcwhalealerts.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 3. List tools
curl -X POST https://mcp.btcwhalealerts.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 4. Call a tool
curl -X POST https://mcp.btcwhalealerts.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"whale_btc_indicators","arguments":{}}}'

For Premium/Research, complete the OAuth flow first via /oauth/authorize, then add Authorization: Bearer <token> to subsequent calls.