Graph Polymarket MCP vs Polymarket Paper Trader

A side-by-side look at the Graph Polymarket MCP and Polymarket Paper Trader MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

Graph Polymarket MCP logoGraph Polymarket MCPFinance & Fintech · Local subprocess (stdio)Polymarket prediction market data via The Graph — markets, positions, orders, user activity, and real-time odds.64GoodAuth: api key requiredPolymarket Paper Trader logoPolymarket Paper TraderFinance & Fintech · Local subprocess (stdio)Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.65GreatAuth: not declared

Verdict: choose Graph Polymarket MCP for finance & fintech work as a local process; choose Polymarket Paper Trader for finance & fintech as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

Graph Polymarket MCP logoChoose Graph Polymarket MCP when

  • You need dedicated capabilities in the Finance & Fintech domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: API key required.
  • You have the keys it needs: GRAPH_API_KEY, MCP_HTTP_PORT.
  • You want tools like list_subgraphs, get_subgraph_schema, query_subgraph.
Explore Graph Polymarket MCP

Polymarket Paper Trader logoChoose Polymarket Paper Trader when

  • You need dedicated capabilities in the Finance & Fintech domain.
  • You prefer a local stdio subprocess transport.
  • You want tools like init_account, get_balance, reset_account.
Explore Polymarket Paper Trader

Feature & specification comparison

Rows where the two servers differ are marked.

SpecGraph Polymarket MCP logoGraph Polymarket MCPPolymarket Paper Trader logoPolymarket Paper Trader
CategoryFinance & FintechFinance & Fintech
Quality signal64/100 · Good65/100 · Great
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthAPI key requiredNot declared
PricingFreeNot declared
Required env varsGRAPH_API_KEYMCP_HTTP_PORTNone listed
Verified ownerCommunity listingCommunity listing
GitHub stars4492
Directory activity 2 views 0 installs 0 upvotes 4 views 0 installs 0 upvotes
Tools3530

Tools & capabilities

Graph Polymarket MCP tools 35

  • list_subgraphsList all available Polymarket subgraphs with descriptions and key entities
  • get_subgraph_schemaGet the full GraphQL schema (introspection) for a Polymarket subgraph
  • query_subgraphExecute a custom GraphQL query against a Polymarket subgraph
  • get_market_dataGet Polymarket market/condition data including outcomes and volumes from the Main subgraph
  • get_account_pnlGet a trader's P&L and performance metrics from the Beefy P&L subgraph
  • get_user_positionsGet a user's current positions from the Slimmed P&L subgraph. Falls back gracefully if indexers are behind.
  • get_recent_activityGet recent splits, merges, and redemptions from the Activity subgraph
  • get_orderbook_tradesGet recent order fills from the Orderbook subgraph
  • get_global_statsGet aggregate Polymarket platform statistics. Combines market counts from the Main subgraph with accurate volume/fee/trade data from the Orderbook subgraph.
  • get_daily_statsGet daily platform statistics from the Beefy P&L subgraph: volume, fees, trader counts, and market activity per day. Use this for trend analysis and historical performance.
  • get_top_tradersGet the top Polymarket traders ranked by realized P&L, win rate, or volume from the Beefy P&L subgraph.
  • get_market_positionsGet the top positions for a specific market token from the Beefy P&L subgraph. Shows who holds the largest positions and their P&L.
  • +23 more on the listing page

Polymarket Paper Trader tools 30

  • init_accountInitialize a paper trading account with starting balance (USD). Creates a new account or resets an existing one.
  • get_balanceGet current account balance (cash, reserved/available cash), positions value, and P&L.
  • reset_accountReset account — deletes all trades, positions, and balance.
  • search_marketsSearch Polymarket for markets matching a query string.
  • list_marketsList active Polymarket markets sorted by volume or liquidity.
  • get_marketGet detailed info for a specific market by slug or condition ID.
  • get_order_bookGet the live order book for a market outcome (asks and bids).
  • get_tagsGet all market categories/tags for filtering.
  • get_markets_by_tagList markets in a specific category/tag.
  • get_eventGet event details — a group of related markets.
  • watch_pricesWatch live midpoint prices for one or more markets. slugs: comma-separated market slugs or condition IDs outcomes: comma-separated outcomes (default: "yes")
  • buyBuy shares in a Polymarket outcome. Spends amount_usd to buy at best available prices. order_type: "fok" (fill-or-kill) or "fak" (fill-and-kill, allows partial).
  • +18 more on the listing page

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

Graph Polymarket MCP

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ],
      "env": {
        "GRAPH_API_KEY": "YOUR_GRAPH_API_KEY_HERE",
        "MCP_HTTP_PORT": "YOUR_MCP_HTTP_PORT_HERE"
      }
    }
  }
}

Polymarket Paper Trader

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "polymarket-paper-trader": {
      "command": "uvx",
      "args": [
        "--from",
        "polymarket-paper-trader",
        "pm-trader-mcp"
      ]
    }
  }
}

Frequently asked questions

Graph Polymarket MCP is categorized under Finance & Fintech and uses a local stdio subprocess. Polymarket Paper Trader belongs to Finance & Fintech and uses a local stdio subprocess. Pick Graph Polymarket MCP for finance & fintech work and Polymarket Paper Trader for finance & fintech.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

Graph Polymarket MCP is listed as free. Auth: api key required. Polymarket Paper Trader has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add paulieb14-graph-polymarket-mcp and polymarket-paper-trader as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, Graph Polymarket MCP has a quality signal of 64/100 (Good) with 2 views, 0 installs and 4 GitHub stars. Polymarket Paper Trader has 65/100 (Great) with 4 views, 0 installs and 492 GitHub stars.