Parlay — Prediction Market MCP Server

The AI-native intelligence layer for prediction markets.

Parlay is a hosted MCP server for searching, comparing, and briefing prediction markets from AI assistants. It is a PMXT-backed aggregator over Polymarket, Kalshi, and Limitless, with Manifold treated separately as a sentiment-only signal. This repository is the public bundle and connection reference for the hosted Parlay service at `https://mcp.parlay.run/mcp`; it does not contain the MCP server implementation.

What it does

Every tool response carries unified metadata: data freshness, venues queried, venues failed, market type (`real_money` / `sentiment` / `mixed`), match confidence (`high` / `medium` / `low` / `not_applicable`), liquidity status, risk flags, and a standard non-trade-recommendation disclaimer.

Connect

Parlay supports two connection paths depending on your client.

Path A — Claude.ai (Desktop, web, mobile, Cowork)

Parlay connects through Claude's Custom Connectors interface. The same flow works across all Claude surfaces.

1. Open Claude settings (profile icon → Settings).

2. In the sidebar, select Connectors.

3. Scroll to the bottom and click Add custom connector.

4. Enter URL: `https://mcp.parlay.run/mcp`

5. Click Add, then Connect to complete OAuth authorization.

Parlay's tools will appear in your tool list on the next message.

> Note: Custom Connectors are available on Free, Pro, Max, Team, and Enterprise plans. Free Claude users are limited to one custom connector at a time. Do not configure Parlay through `claude_desktop_config.json` — that file is for local stdio MCP servers only; Parlay is a remote MCP server.

Path B — OpenClaw, Cursor, Cline, Claude Code, LobeHub, and other JSON-config clients

These clients read MCP server configuration from a JSON file and don't run an OAuth dance themselves. Use a personal access token instead.

1. Generate a token at https://parlay.run/settings/tokens

2. Export it: `export PARLAY_TOKEN=parlay_pat_xxxxxxxxxxxx`

Security: Treat your token as a secret. Do not share, log, or commit it. Store it only in your local MCP client configuration.

Cline

Recommended: Use Cline's Remote Servers tab → "Add Server", entering `https://mcp.parlay.run/mcp` as the URL, selecting Streamable HTTP as the Transport Type, and adding `Authorization: Bearer ` as a header.

For manual JSON editing or detailed troubleshooting, see llms-install.md. Do not copy `.mcp.json` verbatim into Cline — Cline uses a slightly different schema (covered in the install guide).

OpenClaw

git clone https://github.com/parlay-run/parlay-mcp.git
openclaw plugins install ./parlay-mcp
openclaw gateway restart

Cursor / Claude Code

Drop the `parlay` entry from `.mcp.json` (at the root of this repo) into your client's MCP server config.

{
  "mcpServers": {
    "parlay": {
      "url": "https://mcp.parlay.run/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ${PARLAY_TOKEN}"
      }
    }
  }
}

Coverage

• Real-money: Polymarket, Kalshi, Limitless
• Sentiment (architecturally separated): Manifold
• Catalog-only: Smarkets, Myriad, Metaculus, Probable, Baozi

Compliance posture

• Read-only. No order placement, no position management, no fund custody.
• No private credentials handled. Users never share venue API keys with Parlay.
• Sentiment isolation. Manifold is mechanically excluded from real-money tools (`compare_markets`, `scan_discrepancies`). The `sentiment_market_excluded` risk flag is emitted whenever it is filtered out.
• Settlement and liquidity risk flags. Markets with weak settlement criteria, missing volume data, or stale signals carry explicit risk flags in their metadata.
• Standard disclaimers. Every tool response carries a non-trade-recommendation disclaimer in its metadata block.

Claude / ChatGPT / Gemini / OpenClaw
                              ↕  (MCP over HTTPS)
                    ┌────────────────────┐
                    │  mcp.parlay.run    │
                    │   (this server)    │
                    └────────┬───────────┘
                             │
                ┌────────────┴────────────┐
                ↓                         ↓
       Real-money data layer    Sentiment data layer
       Polymarket, Kalshi       Manifold
       + secondary venues       (isolated)

Pricing

• Free: 15 tool calls / month (search_markets, market_brief)
• Pro: $29/mo, 150 calls / month
• Team: coming soon, 1,500 calls / month

Built on

Parlay's real-money venue access is built on PMXT, an open-source unified SDK for prediction market venues. Parlay adds the AI intelligence layer on top: event comparability, settlement-risk metadata, sentiment isolation, and tool orchestration for MCP. PMXT trading methods are explicitly not exposed by Parlay — the hosted product is read-only by design.

Resources

• parlay.run
• Server endpoint: https://mcp.parlay.run/mcp

License

This repository — including connection examples, metadata, and client configuration files for the hosted Parlay MCP service — is licensed under the MIT License. See LICENSE. The repository/service licensing split is also described in TERMS.md.

The hosted Parlay service at `mcp.parlay.run`, Parlay brand assets, APIs, data products, pricing, accounts, and service outputs are proprietary and governed by the Parlay Terms of Service: https://www.parlay.run/terms-of-service.