predgeAI/whale-data-mcp

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
> MAXPRICEUSD ($0.05 by default) before any money moves. Use a dedicated,
> low-balance buyer wallet.
## Get a free key
Free pilot key in a minute: https://predge.io/start (no card)
With the MCP server: claude mcp add predge-whale-data -e PREDGEKEY=pdgpilot... -- 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.
bash
export PREDGEKEY=pdgpilot... # from predge.io/start
curl -s https://api.predge.io/v1/verdicts \
-H 'content-type: application/json' \
-H "x-predge-key: $PREDGEKEY" \
-d '{"job":{"endpoint":"https://api.example.com/v1/report","expectedcontenttype":"application/json","requiredfields":["rows"]},
"delivery":{"status":200,"headers":{"content-type":"application/json"},"body":"{\"rows\":[1]}"},
"payment":{"amountusd":0.25,"payer":"0xBuyer","payee":"0xMerchant"}}'
The response carries verdict (delivered / notdelivered / inconclusive), reasoncodes, an ed25519 attestation and a verifyurl. 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.
## Install (one command)
Claude Code:
bash
claude mcp add predge-whale-data \
-e BUYERPRIVATEKEY=0xYOURFUNDEDBASEMAINNETKEY \
-e X402NETWORK=base \
-- npx -y @predge/whale-data-mcp
Claude Desktop / Cursor / any MCP client — add to the client's MCP config:
json
"mcpServers": {
"predge-whale-data": {
"command": "npx",
"args": ["-y", "@predge/whale-data-mcp"],
"env": {
"BUYERPRIVATEKEY": "0xYOURFUNDEDBASEMAINNETKEY",
"X402NETWORK": "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).
### Optional: a Predge key (PREDGEKEY)
Set PREDGEKEY and the server sends it as the x-predge-key header on every request:
Pilot key, free, from https://predge.io/start (email, no card): the settlement
estimate (predgesettlementestimate) and delivery verdicts (predgeverdict) are
free for 30 days, and predgeverdictreport returns your signed monthly report.
After the window those calls answer 402 again; with a buyer key they then pay per call.
Desk key, from https://predge.io/desk (14-day trial): predgedeskconfig.
bash
claude mcp add predge-whale-data -e PREDGEKEY=pdgpilot... -- npx -y @predge/whale-data-mcp