
MCP server for the Predge Whale Data x402 API — Polymarket whale trades & smart-money signals as
MCP server for the Predge Whale Data x402 API — Polymarket whale trades & smart-money signals as agent tools, paid per call in USDC on Base. Bring a funded wallet key.
·
MCP server that exposes the Predge API at https://api.predge.io
(signed delivery verdicts for AI-agent payments, Polymarket whale trades,
smart-money signals, signed attestations, and free signed UMA settlement risk)
as tools. Payment is handled under the hood:
each paid tool call signs a USDC micropayment via an x402 client — the agent
just calls the tool and gets data back. You supply a funded buyer key.
Defaults to Base mainnet (the live Predge API is mainnet-only). Paid tools spend real USDC — typically $0.005–$0.03/call, hard-capped at
MAX_PRICE_USD($0.05 by default) before any money moves. Use a dedicated, low-balance buyer wallet.
Free pilot key in a minute: https://predge.io/start (no card)
With the MCP server: claude mcp add predge-whale-data -e PREDGE_KEY=pdg_pilot_... -- npx -y @predge/whale-data-mcp (no wallet needed for the calls the key covers, see Optional: a Predge key below).
First call over plain HTTP: a signed delivery verdict for a paid agent call.
export PREDGE_KEY=pdg_pilot_... # from predge.io/start
curl -s https://api.predge.io/v1/verdicts \
-H 'content-type: application/json' \
-H "x-predge-key: $PREDGE_KEY" \
-d '{"job":{"endpoint":"https://api.example.com/v1/report","expected_content_type":"application/json","required_fields":["rows"]},
"delivery":{"status":200,"headers":{"content-type":"application/json"},"body":"{\"rows\":[1]}"},
"payment":{"amount_usd":0.25,"payer":"0xBuyer","payee":"0xMerchant"}}'The response carries verdict (delivered / not_delivered / inconclusive), reason_codes, an ed25519 attestation and a verify_url. Docs: predge.io/docs#verdicts.
No key? Pay per call over x402 instead: the same request without x-predge-key answers 402 with the price ($0.05), payable in USDC by any x402 client.
Claude Code:
claude mcp add predge-whale-data \
-e BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_MAINNET_KEY \
-e X402_NETWORK=base \
-- npx -y @predge/whale-data-mcpClaude Desktop / Cursor / any MCP client — add to the client's MCP config:
{
"mcpServers": {
"predge-whale-data": {
"command": "npx",
"args": ["-y", "@predge/whale-data-mcp"],
"env": {
"BUYER_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_MAINNET_KEY",
"X402_NETWORK": "base"
}
}
}
}That's it — the agent gets 25 tools (18 paid routes + 7 free tools: discovery, settlement risk, verdict re-read, verdict report, key status, Desk config, record verification). Discovery, settlement risk, verdict re-read and record verification need no key at all. No account; the buyer key pays USDC per call on Base or Solana. Fund it with a few dollars of USDC (the facilitator pays gas, so no ETH/SOL needed).
PREDGE_KEY)Set PREDGE_KEY and the server sends it as the x-predge-key header on every request:
predge_settlement_estimate) and delivery verdicts (predge_verdict) are
free for 30 days, and predge_verdict_report returns your signed monthly report.
After the window those calls answer 402 again; with a buyer key they then pay per call.predge_desk_config.claude mcp add predge-whale-data -e PREDGE_KEY=pdg_pilot_... -- npx -y @predge/whale-data-mcpThe key goes first: a call it covers never pays, even with a buyer key set. Without a key or a buyer wallet, a paid tool returns the API's 402 explanation (price, networks, how to pay, where to get a pilot key) instead of failing opaquely. The key is never logged and never copied into a tool result.
ElizaOS — add to your character file (via @fleek-platform/eliza-plugin-mcp):
{
"plugins": ["@fleek-platform/eliza-plugin-mcp"],
"settings": {
"mcp": {
"servers": {
"predge": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@predge/whale-data-mcp"],
"env": { "BUYER_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_MAINNET_KEY", "MAX_PRICE_USD": "0.05" }
}
}
}
}
}Set MAX_PRICE_USD to hard-cap spend — any call above it is refused before payment. Full
integration guide (ElizaOS, Claude, raw x402 for non-MCP stacks, spend caps): https://predge.io/docs#whale-data
| Tool | Price | Returns |
|---|---|---|
predge_list_endpoints | free | API description + every endpoint with its price/schema (call first) |
predge_settlement_risk | free | Signed live UMA settlement risk for one Polymarket market, read from Polygon: UMA state, current proposal + challenge window, every dispute, UMA-vote status, bulletin-board updates, on-chain resolution, risk_level (ok|watch|caution|resolved), segment_dispute_rate, settlement_estimate_available. The settlement_estimate itself is paid: predge_settlement_estimate. The tool re-verifies the ed25519 signature and returns { verification, record }. Param: market (condition id, numeric market id, or slug). 60 req/min per IP |
predge_settlement_estimate | ~$0.02; free with a pilot key | Same signed settlement-risk record with settlement_estimate (statistic from 2026 Polymarket UMA disputes, not advice). GET /v1/settlement-risk/:market/estimate. Check settlement_estimate_available in the free record first. Returns { verification, record }. Param: market |
predge_verdict ⭐ | $0.05 / $0.50; free with a pilot key | Delivery verdict: was the paid job delivered? Send job (what was promised: endpoint, expected_content_type, json_schema, required_fields, max_latency_ms, expected_sha256…), delivery (evidence: status, headers, body or body_sha256, timing), payment (amount_usd, tx_hash, network, payer, payee), optional agent / provider_agent (id, version, operator, authorization_ref). payment.amount_usd < 1 → POST /v1/verdicts ($0.05), ≥ 1 → POST /v1/verdicts/large ($0.50; paying it over x402 needs MAX_PRICE_USD ≥ 0.5). Returns a signed verdict (delivered | not_delivered | inconclusive), per-check results, reason codes and a refund recommendation, as { verification, record } |
predge_get_verdict | free | GET /v1/verdicts/:id: re-read a stored signed verdict, re-verified. Param: id (vrd_ + 24 chars) |
predge_verdict_report | free, needs PREDGE_KEY | GET /v1/verdicts/report: signed monthly dispute-handling report for the verdicts your key requested (counts, refund recommendations, reason codes, time to verdict, verdict ids). Params: month (YYYY-MM), merchant_id, limit, cursor, sample |
predge_key_status | free, needs PREDGE_KEY | GET /v1/me: your key's plan, quota and pilot expiry |
predge_desk_config | free, needs a Desk key | GET /v1/desk/config: watched wallets, alert targets (webhook, Telegram), plan status |
predge_verify_record | free | Offline check of any Predge signed record (predge-attest-v1): C(payload) == canonical, sha256(canonical) == content_hash, ed25519 signature, envelope_signature, and signer listed active in predge-keys.json. Param: record (JSON string) |
predge_whales_latest | ~$0.005 | Latest whale trades ≥$10k (15-min delay). Param: limit (1-100) |
predge_whale_market | ~$0.01 | 7-day whale activity for one market. Param: condition_id |
predge_signals_daily | ~$0.02 | 24h digest: top markets, net flow, largest bets |
predge_wallets_leaderboard | ~$0.01 | Wallets ranked by edge over resolved markets. Params: window (7d|30d), limit |
predge_wallet_profile | ~$0.01 | Wallet score, win rates, categories, last 20 trades. Param: address |
predge_markets_movers | ~$0.005 | Largest YES-price moves. Param: window (1h|6h|24h) |
predge_signals_consensus | ~$0.03 | Edge-verified smart-money net flow + direction per market |
predge_attest ⭐ | ~$0.02 | Flagship. Resolved-outcome attestation — the settled truth for a market (resolved, resolution, resolved_at). Optional side (yes|no) checks whether a past signal/win-rate claim was actually right. Params: condition_id, side |
predge_sports_attest ⭐ | ~$0.02 | Flagship. Ed25519-signed settled game outcome (winner, final score, completed) from ESPN, verifiable offline against Predge's published key. Optional winner (team abbr) → correct. Settle bets / prove a track record on tamper-evident truth. Leagues: nba, wnba, nfl, college-football, mlb, nhl, mls, epl, champions-league, laliga. Params: league, event_id, winner |
predge_bets_biggest | ~$0.005 | Top-20 largest single trades across all markets. Param: window (24h|7d) |
predge_signals_daily_category | ~$0.01 | 24h digest scoped to one category. Param: category |
predge_signals_consensus_category | ~$0.02 | Consensus scoped to one category. Param: category |
predge_signals_market | ~$0.01 | Single-market smart-money verdict ("trust this move?"). Param: condition_id |
predge_wallet_history | ~$0.02 | Wallet trade history + running win-rate & PnL curve. Params: address, window (30d|90d|all) |
predge_wallets_compare | ~$0.02 | Compare 2-10 wallets side-by-side + market overlap. Param: addresses |
predge_market_history | ~$0.01 | Price/volume history for one market. Params: condition_id, window (7d|30d|all) |
Every paid result includes a note with the on-chain settle tx. Not exposed as tools
(raw x402/HTTP reaches them; see predge_list_endpoints): the
/v1/markets/:id/edge polling pulse, the /v1/onchain/* routes, and the signed-calls /
stakes / track-record routes. Paused routes (503 signed_wallet_outputs_paused) have no
tool: the wallet track-record attestation /v1/wallets/:address/attest (the
predge_wallet_attest tool was removed in 0.3.0), /v1/onchain/pm-activity,
/v1/onchain/pm-flows and the free /v1/signal/:address.
Every Predge signed record carries an attestation envelope. The rule is published at
data.predge.io/canonicalization.md:
canonical is the payload as JSON with keys sorted at every level and no whitespace;
content_hash = sha256(canonical); signature is ed25519 over the UTF-8 bytes of
canonical; the signer must be an active key in
https://api.predge.io/.well-known/predge-keys.json (current attestation kid 3b6551a6439b9bda; 13fa3d18a369e6c7 was revoked on 21 Oct 2026).
src/verify.ts implements this with node:crypto only.
Paid tools need a funded key for at least one rail — Base (BUYER_PRIVATE_KEY)
and/or Solana (SOLANA_BUYER_SECRET). Every paid route's 402 offers both networks;
the client pays on whichever it holds a key for (cheapest when both). The
facilitator pays the network fee on either rail — the wallet needs USDC only.
| Var | Default | Notes |
|---|---|---|
PREDGE_KEY | — | Optional. Pilot key (predge.io/start) or Desk key (predge.io/desk), sent as x-predge-key on every request. Never logged. See above. |
BUYER_PRIVATE_KEY | — | Funded Base-mainnet EVM key (0x…) for the Base rail. |
SOLANA_BUYER_SECRET | — | Optional. Funded Solana-mainnet key (64-number JSON array or base58) for the Solana rail. |
X402_NETWORK | base | Base network: base = mainnet (real USDC), base-sepolia only against a testnet deployment. |
X402_SOLANA_NETWORK | matches X402_NETWORK | solana (mainnet) or solana-devnet. |
SOLANA_RPC_URL | @x402/svm default | Optional custom Solana RPC (public mainnet-beta is rate-limited). |
PREDGE_BASE_URL | https://api.predge.io | Override to point at another deployment. PREDGE_API_URL is accepted as an alias. Signatures are always checked against the key set on api.predge.io. |
MAX_PRICE_USD | 0.05 | Any call priced above this is refused before paying. |
PREDGE_MCP_USER_AGENT | predge-whale-data-mcp/<version> | Sent on every request (lets the API attribute MCP traffic). |
predge_list_endpoints,predge_settlement_risk,predge_get_verdictandpredge_verify_recordwork without any key.
Upgrading from 0.1.10 or older: those versions default to a decommissioned API host and every call fails with 404. Upgrade to 0.2.0 (
npx -y @predge/whale-data-mcp@latest), or setPREDGE_BASE_URL=https://api.predge.io.
To exercise the payment path without real money, point PREDGE_BASE_URL at a
Base-Sepolia deployment of the API and set X402_NETWORK=base-sepolia; fund the
buyer from faucet.circle.com. (The public prod API
is mainnet-only, so testnet needs your own deployment.)
MAX_PRICE_USD is enforced in the payment selector, so an
over-cap call is refused before any money moves (no wasted request).BUYER_PRIVATE_KEY from env,
never logs it, and never sends it anywhere but the local signer. Use a
dedicated low-balance wallet and keep the key out of version control.
PREDGE_KEY is only ever placed in the x-predge-key request header to the
Predge API; it is never logged, and an API error that echoes it is redacted.git clone https://github.com/predgeAI/whale-data-mcp.git
cd whale-data-mcp && npm install && npm run build
# then point your MCP client's "command" at node with args ["/abs/path/whale-data-mcp/dist/index.js"]npm test # unit tests (no network, no payment)
npm run inspect # list tools (no payment)
node dist/dev-list-tools.js predge_list_endpoints # free call against prod
node dist/dev-list-tools.js predge_settlement_risk '{"market":"<condition id or slug>"}' # free, signed
# paid call (spends real USDC on mainnet):
BUYER_PRIVATE_KEY=0x… X402_NETWORK=base node dist/dev-list-tools.js predge_whales_latest '{"limit":2}'Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add predge-whale-data -- npx -y @predge/whale-data-mcp{
"mcpServers": {
"predge-whale-data": {
"env": {
"X402_NETWORK": "",
"BUYER_PRIVATE_KEY": ""
},
"args": [
"-y",
"@predge/whale-data-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"predge-whale-data","env":{"X402_NETWORK":"","BUYER_PRIVATE_KEY":""},"args":["-y","@predge/whale-data-mcp"],"command":"npx"}'[mcp_servers.predge-whale-data]
command = "npx"
args = ["-y", "@predge/whale-data-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/whale-data-mcp to learn what the "Whale Data Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add predge-whale-data
claude mcp add predge-whale-data -e PREDGE_KEY=pdg_pilot_... -- npx -y @predge/whale-data-mcp| Name | What it does |
|---|---|
predge_list_endpoints | Free. Returns the Predge API description, network, payTo, and every endpoint with its price and what it returns. Call this first to see what's available before paying. |
predge_whales_latest | PAID (~$0.005). Latest Polymarket whale trades ≥$10k notional (15-min delay): market, side, size, price, wallet address + Predge wallet score. Param: limit (1-100, default 50). |
predge_whale_market | PAID (~$0.01). 7-day whale activity + aggregates (volume, YES/NO split, net flow, unique wallets) for one Polymarket market. Param: condition_id. |
predge_signals_daily | PAID (~$0.02). 24h digest: top markets by whale volume, net flow, largest single bets, totals. |
predge_wallets_leaderboard | PAID (~$0.01). Top wallets by realized win rate over resolved markets. Params: window (7d|30d, default 30d), limit (1-100, default 50). |
predge_wallet_profile | PAID (~$0.01). One wallet's profile: Predge score, win rates (7d/30d), favorite categories, last 20 trades (15-min delay). Param: address (0x…). |
predge_markets_movers | PAID (~$0.005). Largest YES-price moves across active markets (from trade prints). Param: window (1h|6h|24h, default 6h). |
predge_signals_consensus | PAID (~$0.03, premium). Per active market with whale activity in 24h: net flow of smart-money wallets (score > 70), YES/NO volume, and a direction verdict. |
predge_attest | PAID (~$0.02). Resolved-outcome ATTESTATION for one Polymarket market: the SETTLED truth straight off the market row — resolved (bool), resolution (yes|no|null), resolved_at, and outcome_verified:{res |
predge_sports_attest | PAID (~$0.02). Ed25519-SIGNED settled game outcome for one finished match — winner, final score, completed(bool), teams, scheduled time — sourced from ESPN and signed with Predge's published key, so i |
predge_kalshi_attest | PAID (~$0.02). Ed25519-SIGNED settled resolution for one Kalshi market — resolved(bool), resolution (yes|no|null), resolved_at — sourced from Kalshi's public market API and signed with Predge's publis |
predge_wallet_attest | PAID (~$0.02). Ed25519-SIGNED track record for one wallet over RESOLVED Polymarket markets — the wallet's outcome-verified win/loss record signed with Predge's published key, so it VERIFIES OFFLINE ag |
predge_bets_biggest | PAID (~$0.005). Top-20 largest single trades across all Polymarket markets in the window (market, side, size, price, wallet + score). Param: window (24h|7d, default 24h). |
predge_signals_daily_category | PAID (~$0.01). The 24h whale digest scoped to one market category (e.g. politics, economics, sports). Unknown category → 404 (not charged) with the known_categories list. Param: category. |
predge_signals_consensus_category | PAID (~$0.02). Edge-verified smart-money consensus (net flow + direction) scoped to one category. Unknown category → 404 (not charged) with known_categories. Param: category. |
predge_signals_market | PAID (~$0.01). Single-market smart-money VERDICT — the "should you trust this move?" decision for one market: edge-verified smart flow, direction and confidence. Param: condition_id. |
predge_wallet_history | PAID (~$0.02). One wallet's trade history with a running win-rate and modeled-PnL curve. Params: address (0x…), window (30d|90d|all, default 30d). |
predge_wallets_compare | PAID (~$0.02). Side-by-side comparison of 2-10 wallets (scores, win rates, modeled PnL) plus their market overlap. Param: addresses (2-10 0x… addresses). |
predge_market_history | PAID (~$0.01). Price/volume history for one Polymarket market in daily buckets (price normalized to the YES side) plus recent prints. Params: condition_id, window (7d|30d|all, default 30d). |
Read live from the server on September 28, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/whale-data-mcp)Nothing comparable is listed yet.
v0.1.9v0.1.9 — predge_kalshi_attest + predge_wallet_attestRelease notesv0.1.8v0.1.8 — predge_sports_attest (signed settled sports outcomes)Release notesv0.1.6v0.1.6 — Solana payment railRelease notesv0.1.5v0.1.5 — Predge Whale Data MCPRelease notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "whale-data-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.