
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
Tool What it does
search_markets Cross-venue keyword search for live prediction markets and event contracts
market_brief Synthesized brief on a topic, combining real-money signals with community sentiment
discover_markets Browse trending, high-volume, fast-moving, or high-disagreement markets
compare_markets Compare the same event contract across venues side-by-side β probability, liquidity, settlement
scan_discrepancies Surface cross-venue price discrepancies as a discovery feed (informational, not trade recommendations)
inspect_platform Drill into a single named venue
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.
-
Open Claude settings (profile icon β Settings).
-
In the sidebar, select Connectors.
-
Scroll to the bottom and click Add custom connector.
-
Enter URL:
https://mcp.parlay.run/mcp -
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.
-
Generate a token at https://parlay.run/settings/tokens
-
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 <your token> 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). Thesentiment_market_excludedrisk 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
-
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.
This tool doesn't publish a standard install command β the repository README on GitHub covers its setup.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.