{"id":"berlinbra-polymarket-mcp","name":"polymarket-mcp","homepage":null,"repo_url":"https://github.com/berlinbra/polymarket-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","polymarket","prediction-markets","ai-agents","market-data","python"],"what_it_does":"An MCP (Model Context Protocol) server that exposes PolyMarket prediction-market data via four MCP tools: market details, market listing with pagination, current prices, and historical price/volume data over selectable timeframes. It connects to the PolyMarket API using an API key and provides human-readable responses with stated handling for common API error conditions (rate limiting, invalid keys/markets, timeouts, malformed responses).","use_cases":["LLM agents retrieving current prediction market prices and implied probabilities","Agents summarizing market context (category, resolution date, description) for research or forecasting workflows","Monitoring/analysis use cases that need historical price and volume trends","Interactive market discovery with filtering and pagination"],"not_for":["Payment/transaction execution (read-only market data interface)","Use as a public unauthenticated endpoint (authentication to PolyMarket API is required by design)","Production-grade use without confirming the upstream PolyMarket API’s response/limits and the MCP server’s actual runtime behavior"],"best_when":"When an agent platform supports MCP and you want a local MCP server wrapper around PolyMarket’s API to retrieve market data with structured tool calls.","avoid_when":"When you need a hosted, managed service with a published SLA, automatic scaling, or a documented REST/SDK interface instead of MCP tools.","alternatives":["Direct use of the PolyMarket API (if available) from your own backend","Other MCP servers/wrappers for market data (if you already use MCP in your stack)","Community PolyMarket data SDKs or custom scripts using httpx/py-clob-client"],"af_score":70.7,"security_score":52.2,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:44:06.865565+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["PolyMarket API key (provided to MCP server via environment variable/key in .env as Key)","Wallet address/funder (provided via environment variable Funder)"],"oauth":false,"scopes":false,"notes":"README indicates use of API credentials through env vars (.env with Key and Funder). No OAuth flow or explicit OAuth scopes described."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information for the MCP server itself is provided; costs would depend on PolyMarket API usage (not documented here)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":70.7,"security_score":52.2,"reliability_score":32.5,"mcp_server_quality":78.0,"documentation_accuracy":72.0,"error_message_quality":null,"error_message_notes":"Docs claim human-readable error format; however, the README shows only success examples and no concrete error schema/format examples.","auth_complexity":80.0,"rate_limit_clarity":55.0,"tls_enforcement":60.0,"auth_strength":55.0,"scope_granularity":30.0,"dependency_hygiene":50.0,"secret_handling":65.0,"security_notes":"Likely uses env vars for the PolyMarket API key (improving secret hygiene), but the README does not state logging behavior, secret redaction, TLS requirements to the upstream API, or fine-grained authorization controls. No mention of validating untrusted tool inputs beyond expected schema constraints.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":30.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":"Tools appear read-only (market info/prices/history) so they are effectively safe to retry, but the README does not explicitly state idempotency or include any retry guidance.","pagination_style":"offset-limit (list-markets supports limit and offset).","retry_guidance_documented":false,"known_agent_gotchas":["The README includes a snippet for Claude Desktop config under an 'Development/Unpublished' header; it may not reflect the production-ready configuration format.","Rate limits are referenced (429) but no specific retry-after or backoff strategy is documented.","Tool outputs are shown as formatted text blocks rather than explicit machine-readable JSON structures, which can complicate agent parsing."]}}