PolyTest
Read-only MCP server giving AI tools historical Polymarket crypto market data
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Locally or Remotely
- Version
- 0.1.1
- Listing updated
- today
About PolyTest
PolyTest is a freemium MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.
The README describes PolyTest's MCP server as a way for AI clients to read PolyTest market data directly, without writing code. It exposes five read-only tools that return historical Polymarket Up/Down markets for BTC, ETH and SOL, along with snapshots, price series and order books. Price fields are lowest asks on the Up and Down order books rather than midpoints or last trades, and the docs explain that the two usually sum to slightly more than 1.
The server is hosted at a Streamable HTTP endpoint and authenticates either through an OAuth sign-in with a PolyTest account or through a bearer API key. It can also be run locally from the @polytest/mcp npm package, which reads the key from an environment variable. Each tool call counts against the same request limits as the REST API, so the docs recommend a dedicated key for the MCP server.
This suits traders, quants and developers who want an assistant to explore prediction-market history, compare market shapes or check order books at a given moment. For bulk pulls or backtests, the docs point to the TypeScript SDK or REST API instead.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.polytest.io/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.polytest.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.polytest.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.polytest.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.polytest.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.polytest.io/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
POLYTEST_KEYPolyTest API key. Create one at https://www.polytest.io/app/keys.Required
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- polytest_list_markets
- Lists markets of one market_type for one coin, newest first.
- polytest_get_market
- Returns one market by market_id or slug, including token ids and resolution fields.
- polytest_get_snapshots
- Returns snapshots of one market, optionally with order books.
- polytest_get_price_series
- Returns evenly spaced price points across one market.
- polytest_get_limits
- Returns the caller's plan limits and trial budget.
What it does
- Five read-only tools
- Tools cover market listing, single-market lookup, snapshots, price series and plan limits.
- Order book snapshots
- Snapshots can include both Up and Down order books, trimmed to a chosen depth.
- Hosted and local modes
- Connect to the hosted endpoint over HTTP or run the npm package locally over stdio.
- Flexible authentication
- Supports OAuth sign-in or an API key sent in an Authorization or X-API-Key header.
- Coverage and status fields
- Markets carry status values such as upcoming, open, resolved and ended_no_result.
Good for
- Find recent BTC 5m or 15m Polymarket markets and see how the Up price moved
- Pull order books shortly before a market closed to study pre-resolution pricing
- Check plan limits and estimate the request cost of a price series before running it
- Gather historical market data for a backtest prototype through an AI assistant
Pricing
Freemium, from $29 a month
3-day free trial on Builder; Builder $29/mo, Pro $49/mo, Enterprise custom. Trial budget applies.
Prices change. Check polytest.io before you buy.
PolyTest FAQ
Does the MCP server allow placing trades?
No. The docs state that all of its tools are read-only.
Which markets are covered?
BTC, ETH and SOL markets for 5m, 15m and 1hr windows, and BTC only for 4hr and 24hr windows.
How do I authenticate?
Use OAuth sign-in where the client supports it, or send a PolyTest API key in the Authorization header or X-API-Key header.
Do MCP calls use my API quota?
Yes. Every tool call makes ordinary API requests and counts against the same plan limits as REST calls.
Is PolyTest free?
PolyTest has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.
How do I add PolyTest to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://mcp.polytest.io/mcp
What are the best alternatives to PolyTest?
The closest alternatives to PolyTest are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and DataArcus for Power BI.
Where this comes from
- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to PolyTest

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.2K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

DataArcus for Power BI
MCP serverPlan, check and write Power BI reports in English or Arabic from Claude Desktop
Runs locally- 3 tools
- Free
- 1 GitHub star
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data