# PMAxis MCP — 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 PMAxis indexes.

## Ways to connect

### Hosted SSE server (all 60+ tools, requires free API key)

```json
{
  "mcpServers": {
    "pmaxis": {
      "url": "https://mcp.pmaxis.trade/sse?key=YOUR_API_KEY"
    }
  }
}
```

Works in Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), and any SSE-capable client. Get a key at [https://api.pmaxis.trade/signup](https://api.pmaxis.trade/signup).

### stdio via npm (Claude Desktop)

```json
{
  "mcpServers": {
    "pmaxis": {
      "command": "npx",
      "args": ["-y", "@pmaxis/mcp-server"],
      "env": {
        "PMAXIS_API_KEY": "YOUR_API_KEY",
        "PMAXIS_API_URL": "https://api.pmaxis.trade"
      }
    }
  }
}
```

Note: the npm package is on an older release and currently exposes 34 tools; prefer the hosted SSE server for full coverage.

### Public discovery endpoint (no API key)

A read-only MCP server speaking MCP over Streamable HTTP is available at `https://pmaxis.trade/api/mcp`. It exposes platform stats, top markets, and documentation resources — useful for agents that want to inspect PMAxis before signing up.

## Tool catalog (60+ tools)

- **Market discovery** — search_markets, list_markets, get_top_markets, get_trending_markets, get_new_markets, get_resolving_markets, get_breaking_markets, get_markets_by_timeframe, compare_markets
- **Market detail** — get_market, get_market_price, get_market_orderbook, get_market_candles, get_market_trades, get_market_signals, get_market_sentiment, get_market_calibration, get_related_markets, and more
- **Wallet** — search_wallets, get_wallet_summary, get_wallet_pnl, get_wallet_calibration, get_leaderboard, watch/unwatch, and more
- **Wallet clustering** — get_wallet_clusters, get_wallet_cluster (shared-funding-source / Sybil signal)
- **Organization** — get_events, get_categories, get_tags, get_series
- **Platform** — get_platform_stats, get_recent_trades, get_batch_prices, get_current_time, get_pipeline_status, get_top_signals

The full catalog with per-tool descriptions lives at [https://pmaxis.trade/mcp](https://pmaxis.trade/mcp).

## Example prompts

- "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?"
- "Look up wallet 0x123… and summarize its open positions and P&L."

## Links

- [Get a free API key](https://api.pmaxis.trade/signup)
- [REST API reference](https://api.pmaxis.trade/docs)
- [Public discovery MCP endpoint](https://pmaxis.trade/api/mcp)