MCP server for Polymarket prediction markets — 31 tools combining The Graph subgraphs + Polymarket REST APIs (Gamma + CLOB) for market search, live prices, order books, trader P&L, open interest, and resolution data
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add graph-polymarket --env GRAPH_API_KEY='<GRAPH_API_KEY>' -- npx -y graph-polymarket-mcp~/.codex/config.toml
[mcp_servers.graph-polymarket]
command = "npx"
args = ["-y", "graph-polymarket-mcp"]
env = { GRAPH_API_KEY = "<GRAPH_API_KEY>" }
# codex mcp add graph-polymarket --env GRAPH_API_KEY='<GRAPH_API_KEY>' -- npx -y graph-polymarket-mcp~/.cursor/mcp.json
{
"mcpServers": {
"graph-polymarket": {
"command": "npx",
"args": [
"-y",
"graph-polymarket-mcp"
],
"env": {
"GRAPH_API_KEY": "<GRAPH_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"graph-polymarket": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"graph-polymarket-mcp"
],
"env": {
"GRAPH_API_KEY": "<GRAPH_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"graph-polymarket": {
"command": "npx",
"args": [
"-y",
"graph-polymarket-mcp"
],
"env": {
"GRAPH_API_KEY": "<GRAPH_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"graph-polymarket": {
"command": "npx",
"args": [
"-y",
"graph-polymarket-mcp"
],
"env": {
"GRAPH_API_KEY": "<GRAPH_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"graph-polymarket": {
"command": "npx",
"args": [
"-y",
"graph-polymarket-mcp"
],
"env": {
"GRAPH_API_KEY": "<GRAPH_API_KEY>"
}
}
}
}Environment variables
GRAPH_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.