polymarket-info
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
polymarket-info
Cursor / Agent Plugin for Polymarket international public market data:
Gamma (
gamma-api.polymarket.com) — events, markets, search, tags, series, sportsCLOB (
clob.polymarket.com) — books, mids, spreads, prices, batch quotes, tick/fee/neg-risk metaData API (
data-api.polymarket.com) — positions, activity, trades, holders, OI, live volume
Read-only. No API keys. No order placement / CLOB auth / Relayer / Bridge / WebSockets.
Docs: https://docs.polymarket.com/
Marketing (no API catalog): https://institutional.polymarket.com/
Not Polymarket US (docs.polymarket.us / *.polymarketexchange.com).
Domain types
Type | Meaning |
| Gamma market (question, slug, outcomes, |
| Gamma event with nested markets |
| Gamma discovery metadata |
| Gamma public profile by wallet |
| CLOB L2 bids/asks for a |
| CLOB quote helpers (single + batch) |
| historical mid series |
| CLOB-level market params by |
| CLOB market meta |
| Data API open / closed holdings |
| Data API wallet activity & fills |
| Data API analytics |
| Trader leaderboard row |
| Trading eligibility of this machine's IP: |
Model: event → markets → YES/NO outcome tokens. Use token_id from Gamma clobTokenIds on CLOB. Prefer Gamma for discovery; CLOB for live book; Data API for wallet/market analytics (user = 0x address in query).
Related MCP server: mcp-polymarket
Install (Cursor IDE)
Copy to ~/.cursor/plugins/local/polymarket-info (real directory), Reload Window.
Install (Claude Code)
Clone this repo, then start Claude Code with claude --plugin-dir /path/to/polymarket-plugin. .claude-plugin/plugin.json loads the skill and starts the MCP server with node ${CLAUDE_PLUGIN_ROOT}/server/index.mjs. The server has no dependencies, so it needs only Node on PATH and no npm install.
Output
Results are compact JSON text with no
structuredContent.Lists return
{total, returned, offset, truncated, items}withnext_offset(ornext_cursorfor keyset/CLOB pages) when more remain. Defaultlimitis 50 (10 forlist_events, 20 forlist_holders) and every response is capped at 40,000 characters.list_markets,list_events,search,get_eventandget_seriesdefault toresponse_format: "concise"(about 12 market fields; events keep their top 5 markets). Pass"detailed"for every upstream field.get_marketdefaults to detailed.list_marketsandlist_eventsdefault to open markets ending after now, sorted by 24h volume.Upstream and validation errors come back as tool results with
isError: true, the upstream reason, and a hint.Results with market copy or user profiles start with a one-line note that those fields are third-party text.
Env: POLYMARKET_TIMEOUT_MS (default 15000) bounds every upstream call. POLYMARKET_GAMMA_URL, POLYMARKET_CLOB_URL, POLYMARKET_DATA_URL and POLYMARKET_GEOBLOCK_URL override the hosts (the smoke test points them at a local mock).
Test
npm test runs test/smoke.mjs; see PROVE.md for what it checks.
MCP tools (43)
Gamma
Tool | Host |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
CLOB
Tool | Host |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Data API
Tool | Host |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Misc
Tool | Host |
|
|
Licensing note
Capital-markets redistribution of Polymarket data may require Polymarket + ICE licensing. See institutional site / data-licensing@polymarket.com. This plugin is for personal agent tooling, not a data-feed substitute.
License
MIT
Repository
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Polymarket search, market details, order books, price history, and market cards.
Polymarket in your AI: market rules, real fill costs, who is trading, top traders. Read-only.
Read-only market data: tokens, stocks, Hyperliquid perps, Polymarket, and public trader books.
Polymarket MCP — prediction-market data via Gamma + CLOB + Data public APIs.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables interaction with Polymarket prediction markets through read-only access to market data, events, orderbooks, and user positions, plus authenticated trading capabilities for creating and managing orders.1-
- AlicenseNot gradedqualityCmaintenanceProvides access to Polymarket prediction-market data via Gamma and CLOB public APIs, enabling AI agents to query market information.163 npmMIT
- AlicenseAqualityCmaintenanceA read-only MCP server exposing Polymarket's public prediction-market data. Search markets, read live odds and order books, pull historical probability time-series, and inspect public wallet positions.1446 PyPIMIT
- AlicenseAqualityDmaintenanceProvides read-only tools to query live Polymarket prediction-market data via the public Gamma API, enabling search, browsing, and detailed market and event information.4MIT