Polymarket MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POLYMARKET_FUNDER | No | Proxy wallet address (optional, derived if not set) | |
| POLYMARKET_API_KEY | No | API key (auto-derived if not set) | |
| POLYMARKET_CHAIN_ID | No | Polygon mainnet chain ID (default 137) | |
| POLYMARKET_READONLY | No | Disable trading tools when set to true (default false) | |
| POLYMARKET_API_SECRET | No | API secret (auto-derived if not set) | |
| POLYMARKET_PASSPHRASE | No | API passphrase (auto-derived if not set) | |
| POLYMARKET_PRIVATE_KEY | Yes | Wallet private key for signing |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| polymarket_get_marketsB | List available prediction markets on Polymarket, sorted by volume. Returns market question, current prices for Yes/No outcomes, token IDs, volume, liquidity, and Polymarket URL. |
| polymarket_get_marketA | Get detailed information about a specific prediction market including token IDs, current prices, description, liquidity, and market status. Provide one of: condition_id, slug, or a full Polymarket URL (e.g. https://polymarket.com/event/btc-updown-15m-1770647400). |
| polymarket_get_orderbookA | Get the order book for a specific token showing current bids and asks with prices and sizes. |
| polymarket_get_balanceA | Get the USDC balance and allowance for the configured wallet on Polymarket. |
| polymarket_get_positionsA | Get real positions (token holdings) for the configured wallet from Polymarket Data API. Returns actual token balances with P&L, not just open orders. Parameters:
Response includes:
|
| polymarket_update_allowanceA | Trigger a refresh of the USDC allowance for trading on Polymarket. Use this when orders fail due to insufficient allowance. This tells the CLOB server to re-check and update the on-chain allowance state. |
| polymarket_get_newsA | Fetch recent news headlines for a topic via Google News RSS. Useful for understanding current events and market context when analyzing prediction markets. No API key required. |
| polymarket_get_tradesB | Get recent executed trades for the configured wallet. |
| polymarket_place_orderA | Place a limit order on Polymarket. CAUTION: This executes a real trade with real funds. Price must be between 0 and 1, size in shares. |
| polymarket_place_market_orderA | Place a market order on Polymarket for immediate execution. CAUTION: This executes a REAL trade with REAL funds at market price! Parameters:
Examples:
|
| polymarket_cancel_orderC | Cancel an existing order on Polymarket. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool targets a distinct resource or action: market discovery, market detail, order book, balance, positions, trades, allowance, news, and different order types. No two tools have overlapping purposes.
All tools follow the same 'polymarket_' prefix and a consistent verb_noun pattern (get_markets, place_order, cancel_order, update_allowance). Multi-word nouns like place_market_order fit the pattern cleanly.
11 tools is well-scoped for a prediction market server, covering market data, account info, trading actions, and auxiliary news without redundancy.
The core trading lifecycle is mostly covered, but there is no tool to list open orders, which is a significant gap for identifying orders to cancel. The workaround requires retaining order IDs from placement, but a dedicated list tool is missing.