# parlay

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/parlay-run/parlay-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/parlay

## Description
Prediction market aggregator. Search and compare across Polymarket, Kalshi, Limitless, Manifold.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "parlay": {
    "command": "npx",
    "args": ["-y","parlay"]
  }
}
```

## Documentation & README

# Parlay — Prediction Market MCP Server

[![MCP Badge](https://lobehub.com/badge/mcp/parlay-run-parlay-mcp)](https://lobehub.com/mcp/parlay-run-parlay-mcp)

The AI-native intelligence layer for prediction markets.

![Parlay cross-venue spread comparison across Polymarket and Kalshi](https://raw.githubusercontent.com/parlay-run/parlay-mcp/HEAD/docs/hero.png)

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.

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 <your token>` as a header.

For manual JSON editing or detailed troubleshooting, see [llms-install.md](https://github.com/parlay-run/parlay-mcp/blob/HEAD/llms-install.md). **Do not copy `.mcp.json` verbatim into Cline** — Cline uses a slightly different schema (covered in the install guide).

**OpenClaw**

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

```json
{
  "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](https://www.pmxt.dev), 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](https://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](https://github.com/parlay-run/parlay-mcp/blob/HEAD/LICENSE). The repository/service licensing split is also described in [TERMS.md](https://github.com/parlay-run/parlay-mcp/blob/HEAD/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.