python-conventions — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited python-conventions (Rules) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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.
<!-- mcp-name: io.github.0xChron/polymarket-mcp -->
| 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 runThe server listens on streamable HTTP at http://127.0.0.1:8000/mcp.
Verify it is running with the MCP Inspector:
make inspectorConnect 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-mcpFASTMCP_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 imageSee docs/PROJECT_KNOWLEDGE_BASE.md for architecture, conventions, and how to add new tools.
MIT — see LICENSE.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.