Whale Data MCP Server
by predgeaiio.github.predgeAI/whale-data-mcpv0.1.11
Signed settled outcomes (Polymarket, sports, Kalshi) + whale signals as agent tools, paid via x402.
context tax
queued
security
queued
cold start
queued
freshness
Active6d ago
Install Whale Data MCP server
Install in Claude Code
claude mcp add whale-data-predgeai -e BUYER_PRIVATE_KEY='<buyer-private-key>' -e SOLANA_BUYER_SECRET='<solana-buyer-secret>' -- npx -y @predge/whale-data-mcpInstall in Cursor
{
"mcpServers": {
"whale-data-predgeai": {
"command": "npx",
"args": [
"-y",
"@predge/whale-data-mcp"
],
"env": {
"BUYER_PRIVATE_KEY": "<buyer-private-key>",
"SOLANA_BUYER_SECRET": "<solana-buyer-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"whale-data-predgeai": {
"command": "npx",
"args": [
"-y",
"@predge/whale-data-mcp"
],
"env": {
"BUYER_PRIVATE_KEY": "<buyer-private-key>",
"SOLANA_BUYER_SECRET": "<solana-buyer-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"whale-data-predgeai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@predge/whale-data-mcp"
],
"env": {
"BUYER_PRIVATE_KEY": "<buyer-private-key>",
"SOLANA_BUYER_SECRET": "<solana-buyer-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"whale-data-predgeai": {
"command": "npx",
"args": [
"-y",
"@predge/whale-data-mcp"
],
"env": {
"BUYER_PRIVATE_KEY": "<buyer-private-key>",
"SOLANA_BUYER_SECRET": "<solana-buyer-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BUYER_PRIVATE_KEY | — | yes | Funded Base-mainnet key that signs USDC micropayments. Either this or SOLANA_BUYER_SECRET enables paid tools; the free discovery tool needs neither. |
| X402_NETWORK | — | — | x402 network: 'base' (mainnet, real USDC) or 'base-sepolia' (only against a testnet deployment). |
| MAX_PRICE_USD | — | — | Hard per-call price cap in USD. Calls priced above it are refused before any payment. Default 0.05. |
| PREDGE_BASE_URL | — | — | Override the API base URL. Defaults to the production deployment. |
| SOLANA_BUYER_SECRET | — | yes | Funded Solana-mainnet key (64-number JSON array or base58) to also pay on Solana. Optional — either this or BUYER_PRIVATE_KEY enables paid tools. |
| X402_SOLANA_NETWORK | — | — | Solana network: 'solana' (mainnet) or 'solana-devnet'. Defaults to match X402_NETWORK's testnet-ness. |
| SOLANA_RPC_URL | — | — | Optional custom Solana RPC (the public mainnet-beta endpoint is rate-limited). |
Freshness
Active — last maintenance signal 6d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-04 · 6d ago · GitHub
Latest release
2026-07-29 · 2mo ago · GitHub · v0.1.9
Package published
no data · npm/PyPI
Registry entry updated
2026-10-03 · 7d ago · official registry · v0.1.11
FAQ
›How do I install the Whale Data MCP server in Claude Code?
Run: claude mcp add whale-data-predgeai -e BUYER_PRIVATE_KEY='<buyer-private-key>' -e SOLANA_BUYER_SECRET='<solana-buyer-secret>' -- npx -y @predge/whale-data-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Whale Data require an API key?
Yes. It expects BUYER_PRIVATE_KEY, SOLANA_BUYER_SECRET, of which 2 are secrets.
›Can I use Whale Data as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Whale Data in the official MCP registry?
Yes, as io.github.predgeAI/whale-data-mcp.