Signed delivery verdicts for agent payments, Polymarket settlement risk and whale data, via x402.
Connect Runs on your machine
claude mcp add whale-data-mcp -e BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> -e PREDGE_KEY=<PREDGE_KEY> -e X402_NETWORK=<X402_NETWORK> -e MAX_PRICE_USD=<MAX_PRICE_USD> -e PREDGE_BASE_URL=<PREDGE_BASE_URL> -e SOLANA_BUYER_SECRET=<SOLANA_BUYER_SECRET> -e X402_SOLANA_NETWORK=<X402_SOLANA_NETWORK> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -- npx -y @predge/[email protected]{
"mcpServers": {
"whale-data-mcp": {
"command": "npx",
"args": [
"-y",
"@predge/[email protected]"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
"PREDGE_KEY": "<PREDGE_KEY>",
"X402_NETWORK": "<X402_NETWORK>",
"MAX_PRICE_USD": "<MAX_PRICE_USD>",
"PREDGE_BASE_URL": "<PREDGE_BASE_URL>",
"SOLANA_BUYER_SECRET": "<SOLANA_BUYER_SECRET>",
"X402_SOLANA_NETWORK": "<X402_SOLANA_NETWORK>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
}
}
}
}{
"mcpServers": {
"whale-data-mcp": {
"command": "npx",
"args": [
"-y",
"@predge/[email protected]"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
"PREDGE_KEY": "<PREDGE_KEY>",
"X402_NETWORK": "<X402_NETWORK>",
"MAX_PRICE_USD": "<MAX_PRICE_USD>",
"PREDGE_BASE_URL": "<PREDGE_BASE_URL>",
"SOLANA_BUYER_SECRET": "<SOLANA_BUYER_SECRET>",
"X402_SOLANA_NETWORK": "<X402_SOLANA_NETWORK>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
}
}
}
}{
"servers": {
"whale-data-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@predge/[email protected]"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
"PREDGE_KEY": "<PREDGE_KEY>",
"X402_NETWORK": "<X402_NETWORK>",
"MAX_PRICE_USD": "<MAX_PRICE_USD>",
"PREDGE_BASE_URL": "<PREDGE_BASE_URL>",
"SOLANA_BUYER_SECRET": "<SOLANA_BUYER_SECRET>",
"X402_SOLANA_NETWORK": "<X402_SOLANA_NETWORK>",
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
BUYER_PRIVATE_KEYOptional, secret | Funded Base-mainnet key that signs USDC micropayments. Either this or SOLANA_BUYER_SECRET enables paid tools; the free tools (discovery, settlement risk, verdict re-read, record verification) need neither, and PREDGE_KEY covers the calls its pilot includes. |
PREDGE_KEYOptional, secret | Optional Predge key, sent as x-predge-key on every request. A free 30-day pilot key (predge.io/start) makes the settlement estimate and delivery verdicts free and unlocks the verdict report; a Desk key (predge.io/desk) unlocks predge_desk_config. |
X402_NETWORKOptional | x402 network: 'base' (mainnet, real USDC) or 'base-sepolia' (only against a testnet deployment). |
MAX_PRICE_USDOptional | Hard per-call price cap in USD. Calls priced above it are refused before any payment. Default 0.05. |
PREDGE_BASE_URLOptional | Override the API base URL (alias: PREDGE_API_URL). Defaults to https://api.predge.io. |
SOLANA_BUYER_SECRETOptional, secret | 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_NETWORKOptional | Solana network: 'solana' (mainnet) or 'solana-devnet'. Defaults to match X402_NETWORK's testnet-ness. |
SOLANA_RPC_URLOptional | Optional custom Solana RPC (the public mainnet-beta endpoint is rate-limited). |
Details
| Package | @predge/[email protected] (NPM, stdio) |
| First published | 1 Nov 2026 |
| Last updated | 1 Nov 2026 |
| Registry name | io.github.predgeAI/whale-data-mcp |
More finance and crypto servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.