Skip to content
MCP server

PolyTest

Read-only MCP server giving AI tools historical Polymarket crypto market data

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.polytest.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.polytest.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers

Alternatives to PolyTest

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Plan, check and write Power BI reports in English or Arabic from Claude Desktop

    Runs locally
    • 3 tools
    • Free
    • 1 GitHub star
    • Analytics and data
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data