# PolyTest

> PolyTest is a freemium MCP server for analytics and data. Read-only MCP server giving AI tools historical Polymarket crypto market data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI, Web, macOS, Windows, Linux, vscode
- **Website:** https://www.polytest.io/docs/mcp
- **MCP Registry name:** io.polytest/mcp
- **Categories:** analytics and data, crypto and web3
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.polytest.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.polytest.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.polytest.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.polytest.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.polytest.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.polytest.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ImportYeti Scraper (Apify) - US import records and bills of lading](https://ai-powered.com/mcp/importyeti-scraper-apify-us-import-records-and-bills-of-ladi): ImportYeti Scraper (Apify) - US import records and bills of lading is a paid MCP server for web search and scraping.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/polytest
