graph-polymarket-mcp
MCP server for querying Polymarket prediction market data via The Graph subgraphs.
Exposes 9 tools that AI agents (Claude, Cursor, etc.) can use to query market data, trader P&L, positions, activity, and orderbook trades.
Prerequisites
You need a free Graph API key (takes ~2 minutes):
- Go to The Graph Studio
- Connect your wallet (MetaMask, WalletConnect, etc.)
- Click "API Keys" in the sidebar and create one
- Free tier includes 100,000 queries/month
Installation
npm install -g graph-polymarket-mcp
Or use directly with npx:
npx graph-polymarket-mcp
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"graph-polymarket": {
"command": "npx",
"args": ["-y", "graph-polymarket-mcp"],
"env": {
"GRAPH_API_KEY": "your-api-key-here"
}
}
}
}
Claude Code
claude mcp add graph-polymarket -- npx -y graph-polymarket-mcp
Set the environment variable GRAPH_API_KEY before running.
Cursor / Other MCP Clients
Use the stdio transport with npx graph-polymarket-mcp as the command, passing GRAPH_API_KEY as an environment variable.
Available Tools
Core Tools
| Tool | Description |
|---|---|
list_subgraphs | List all available Polymarket subgraphs with descriptions and key entities |
get_subgraph_schema | Get the full GraphQL schema for a specific subgraph |
query_subgraph | Execute a custom GraphQL query against any subgraph |
Domain-Specific Tools
| Tool | Description | Subgraph |
|---|---|---|
get_market_data | Get market/condition data with outcomes and volumes | Main |
get_account_pnl | Get a trader's P&L and performance metrics | Beefy P&L |
get_user_positions | Get a user's current positions | Slimmed P&L |
get_recent_activity | Get recent splits, merges, and redemptions | Activity |
get_orderbook_trades | Get recent order fills | Orderbook |
get_global_stats | Get aggregate platform statistics | Main |
Subgraphs
| Name | IPFS Hash | Description |
|---|---|---|
| Main | QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a | Complete ecosystem data |
| Beefy P&L | QmbHwcGkumWdyTK2jYWXV3vX4WyinftEGbuwi7hDkhPWqG | Comprehensive P&L tracking |
| Slimmed P&L | QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9ibTiTtwQU | Minimal position data |
| Activity | Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP | Position management events |
| Orderbook | QmVGA9vvNZtEquVzDpw8wnTFDxVjB6mavTRMTrKuUBhi4t | Order fill analytics |
Example Queries
Once connected, an AI agent can:
- "What are the current Polymarket global stats?"
- "Show me the latest 20 orderbook trades"
- "What are the positions for address 0x...?"
- "Get the P&L for trader 0x...?"
- "Query the main subgraph for all conditions with more than 100 trades"
Development
git clone https://github.com/PaulieB14/graph-polymarket-mcp.git
cd graph-polymarket-mcp
npm install
npm run build
GRAPH_API_KEY=your-key node build/index.js
License
MIT