Server data from the Official MCP Registry
Read-only Polymarket prediction market data for AI agents.
Read-only Polymarket prediction market data for AI agents.
Valid MCP server (2 strong, 4 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry.
10 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Set these up before or after installing:
Environment variable: GAMMA_URL
Environment variable: DATA_URL
Environment variable: DEFAULT_TIMEOUT
Environment variable: FASTMCP_HOST
Environment variable: FASTMCP_PORT
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-0xchron-polymarket-mcp": {
"args": [
"0xchron-polymarket-mcp"
],
"command": "uvx"
}
}
}From the project's GitHub README.
MCP server that exposes read-only Polymarket prediction market data to AI agents. Tools wrap Polymarket's public Gamma (market discovery) and Data (positions, portfolio, leaderboard) APIs. There is no CLOB integration — this server cannot place trades or read order books.
| Tool | Description |
|---|---|
search_markets | Search markets by title or description |
get_market_details | Full details for a single market (by slug or Polymarket URL) |
get_user_positions | Open positions for a wallet address |
get_user_performance | Portfolio value, P&L, volume, and leaderboard rank |
All tools return markdown formatted for agent consumption. No API keys or wallet signing are required.
Clone the repo, install dependencies, and start the server:
git clone https://github.com/0xChron/polymarket-mcp.git
cd polymarket-mcp
uv sync
make run
The server listens on streamable HTTP at http://127.0.0.1:8000/mcp.
Verify it is running with the MCP Inspector:
make inspector
Connect the inspector to http://localhost:8000/mcp using the Streamable HTTP transport.
This server uses the streamable-http transport (not stdio). Start the server first, then point your client at the /mcp endpoint.
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-scoped):
{
"mcpServers": {
"polymarket": {
"url": "http://localhost:8000/mcp"
}
}
}
Restart Cursor (or reload the window) after saving. The server must be running before the client connects.
Any MCP client that supports streamable HTTP can connect to the same URL. Refer to your client's documentation for remote server configuration.
Once connected, an agent can call tools naturally:
0x…"0x…?"Build and run the container:
make build
docker run --rm -p 8000:8000 -e FASTMCP_HOST=0.0.0.0 polymarket-mcp
FASTMCP_HOST=0.0.0.0 is required so the server accepts connections from outside the container. Then connect your MCP client to http://localhost:8000/mcp.
Optional environment variables override API endpoints and server settings:
| Variable | Default | Description |
|---|---|---|
GAMMA_URL | https://gamma-api.polymarket.com | Gamma API base URL |
DATA_URL | https://data-api.polymarket.com | Data API base URL |
DEFAULT_TIMEOUT | 15 | HTTP request timeout (seconds) |
FASTMCP_HOST | 127.0.0.1 | Bind address (0.0.0.0 for Docker) |
FASTMCP_PORT | 8000 | Listen port |
make run # Start the server
make test # Run tests
make inspector # Open MCP Inspector
make build # Build Docker image
See docs/PROJECT_KNOWLEDGE_BASE.md for architecture, conventions, and how to add new tools.
MIT — see LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.