Model Context Protocol · 53 live tools

Ask your AI agent about
any prediction market.

Connect Claude, Cursor, Windsurf, or any MCP-compatible agent to live PMAxis data — prices, orderbooks, signals, and wallet history across every prediction market we index.

Get free API key
01 — Setup

Connect your agent

Pick your agent below. Each has a different config format — the right one is shown automatically.

1
Get a free API key
Sign up at api.pmaxis.trade/signup — no credit card, key issued instantly.
2
Install Node.js 18+
Download from nodejs.org. Confirm with node -v in your terminal.
3
Add to claude_desktop_config.json
Open the file below, paste the config, replace YOUR_API_KEY with your key.
Windows
C:\Users\<name>\AppData\Roaming\Claude\claude_desktop_config.json
macOS
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pmaxis": {
      "command": "npx",
      "args": ["-y", "@pmaxis/mcp-server"],
      "env": {
        "PMAXIS_API_KEY": "YOUR_API_KEY",
        "PMAXIS_API_URL": "https://api.pmaxis.trade"
      }
    }
  }
}
Requires Node.js 18+. npx downloads the package automatically on first use — no install step needed. Quit Claude Desktop fully from the system tray, then reopen.
4
Quit and reopen Claude Desktop
Quit fully from the system tray (not just close the window). After relaunch, a hammer icon appears in the chat input — click it to confirm PMAxis tools are loaded.
02 — Prompts

What to ask

Once connected, ask naturally. Your agent picks the right tools automatically.

What are the top 5 prediction markets by volume right now?
Find all markets about the 2026 US elections and compare their prices.
Show me the orderbook for the most liquid market today.
Which markets are resolving this week with the highest trading activity?
Analyze the price history of the most popular AI market over 7 days.
Look up wallet 0x123… and summarize its open positions and P&L.
Show me trending markets in the crypto category.
What is the current sentiment and signal for the top AI market?
03 — Tools

53 tools, live data

Every tool calls the PMAxis REST API in real time. No stale data.

Cursor, Windsurf, and the Python SDK connect via the hosted SSE server and get all 53 tools. The @pmaxis/mcp-server npm package (used by the Claude Desktop / npm setup above) is on an older release and currently exposes 34 of these — the newer wallet-calibration, wallet-clustering, and orderbook-history tools aren't in it yet. Prefer Cursor/Windsurf/Python if you need full coverage today.

Market Discovery
search_marketsFull-text search across all markets
list_marketsPaginated list with filters
get_top_marketsHighest-volume markets
get_trending_marketsMarkets with rising activity
get_new_marketsRecently created markets
get_resolving_marketsMarkets closing within 7 days
get_breaking_marketsSharpest price move in the last hour
get_markets_by_timeframeActive markets grouped by duration bucket (5m–long), optional asset filter
compare_marketsSide-by-side market comparison
Market Detail
get_marketFull market profile
get_market_summaryConcise snapshot with key stats
get_market_statsVolume, liquidity, trade counts
get_market_liquidityLiquidity depth breakdown
get_market_sentimentCrowd sentiment indicators
get_market_signalsPre-computed momentum signals
get_market_healthData freshness check for one market
get_market_orderbookCurrent best bid/ask snapshot
get_market_orderbook_historyOrderbook snapshots over time (rolling 2-day window)
get_market_priceCurrent YES/NO prices
get_market_price_historyHistorical price series
get_market_tradesRecent trade history
get_market_candlesOHLCV candlestick data (1m/5m/1h)
get_market_positionsOpen positions in a market
get_related_marketsSemantically similar markets
get_markets_calibrationPlatform-wide: price before resolution vs actual outcome, Brier score
Wallet
search_walletsBrowse/filter wallets by volume, trades, category, recency
get_wallet_summaryPortfolio value and P&L
get_wallet_activityFull trade and activity history
get_wallet_marketsAll markets a wallet has traded
get_wallet_open_positionsCurrent open positions
get_wallet_onchainVerified on-chain transactions
get_wallet_pnlReal realized/unrealized P&L per market, not just volume
get_wallet_calibrationBrier score on resolved positions + unrealized edge on open ones
get_leaderboardTop wallets by traded volume over a window
get_positionsOpen positions for a wallet (Polymarket Data API)
get_closed_positionsClosed/settled positions for a wallet
watch_walletRegister a wallet for richer activity tracking
unwatch_walletStop tracking a wallet
get_watched_walletsList all currently watched wallets
Wallet Clustering
get_wallet_clustersWallets sharing an on-chain USDC funding source — a Sybil/multi-account signal
get_wallet_clusterOne wallet's funding source and every wallet sharing it, plus wallets trading in lockstep with it
Organization
get_eventsTop-level event containers
get_event_marketsMarkets inside an event
get_categoriesMarket category list
get_category_marketsMarkets in a specific category
get_tagsAll available topic tags
get_seriesRecurring market series
Platform
get_platform_statsGlobal volume, trade counts, market totals
get_recent_tradesLatest trades across all markets
get_batch_pricesCurrent prices for multiple markets at once
get_current_timeAuthoritative server time — don't infer 'now' from market data
get_pipeline_statusData-freshness check across discovery/ingestion/trades
get_top_signalsStrongest live trading signals across every market

Ready to start?

Free API key. No credit card. All 53 tools on the free tier.

Get free API keyAPI reference