Skip to main content
Glama
predgeAI

whale-data-mcp

by predgeAI
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@predge/whale-data-mcp

MCP server that exposes the Predge Whale Data x402 API (Polymarket whale trades + smart-money signals) 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.

Install (one command)

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-mcp

Claude 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 19 tools (18 paid routes + 1 free discovery tool). No API keys, 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).

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://data.predge.io/agents

Related MCP server: polymarket-trader-mcp

Tools

Tool

Price

Returns

predge_list_endpoints

free

API description + every endpoint with its price/schema (call first)

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 by realized win rate. 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_kalshi_attest ⭐

~$0.02

Flagship. Ed25519-signed settled Kalshi market resolution (resolved, resolution yes|no, resolved_at) from Kalshi's public API, verifiable offline. Attests the market's own result, not trader data. Optional side (yes|no) → correct. Params: ticker, side

predge_wallet_attest ⭐

~$0.02

Flagship. Ed25519-signed wallet win/loss track record over resolved markets, verifiable offline — turns a self-reported win rate into signed proof. Param: window (7d|30d, default 30d). Params: address, window

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. The two Kalshi routes (anonymous institutional flow) are not yet exposed as tools — they activate when Kalshi ingest is enabled; raw x402/HTTP already reaches them.

Config (env)

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

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

prod API

https://x402-api-production-266e.up.railway.app. Override to point at another deployment.

MAX_PRICE_USD

0.05

Any call priced above this is refused before paying.

PREDGE_MCP_USER_AGENT

predge-whale-data-mcp/0.1.1

Sent on every request (lets the API attribute MCP traffic).

The free predge_list_endpoints tool works without any key.

Testnet

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.)

Safety

  • Price cap — MAX_PRICE_USD is enforced in the payment selector, so an over-cap call is refused before any money moves (no wasted request).

  • Network guard — the client only pays a requirement on the configured network; it won't accidentally settle a mainnet requirement while in testnet mode (or vice-versa).

  • No key handling beyond env — the server reads 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.

Run from source

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"]

Verify locally

npm run inspect                                        # list tools (no payment)
node dist/dev-list-tools.js predge_list_endpoints      # free call against prod
# 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}'
Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1dRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • cryptoiz-mcp

    dadang11
    A
    license
    Not graded
    quality
    C
    maintenance
    AI-powered Solana DEX smart money signals. Detects whale/dolphin accumulation, divergence patterns, and market phase across 170+ tokens. Pay-per-call via x402 USDC micropayments.
    195
    1
    MIT

  • polymarket-trader-mcp

    demwick
    A
    license
    A
    quality
    C
    maintenance
    Trade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.
    48
    281
    14
    MIT

  • soldefi-mcp

    thomenz
    A
    license
    A
    quality
    B
    maintenance
    Paid access to Solana DeFi risk intelligence — rug/honeypot scans, liquidity-pool analysis, and wash-trade-filtered pool rankings. Automatically settles micropayments in USDC via x402.
    10
    464
    MIT

  • x402nano

    Bobjonesgood
    A
    license
    A
    quality
    B
    maintenance
    Provides free Polymarket discovery data alongside paid deep-market intelligence tools via live x402 HTTP handshakes on Base mainnet. It allows AI agents to securely settle real, ultra-low-cost USDC micro-payments (0.05 USDC) directly over the Model Context Protocol.
    4
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/predgeAI/whale-data-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server