JamesANZ/prediction-market-mcp

Real-time prediction market data in your AI workflow. Get current odds and prices from Polymarket, PredictIt, and Kalshi. No API keys required.

An MCP (Model Context Protocol) server that brings live prediction market data into AI coding environments like Cursor and Claude Desktop.

Trust Score

Why Use Prediction Markets MCP?

• 🆓 No API Keys – Works out of the box, zero configuration
• 📈 Multi-Platform – Polymarket, PredictIt, and Kalshi in one interface
• ⚡ Real-time Data – Current odds and prices from live markets
• 🎯 Easy Setup – One-click install in Cursor or simple manual setup
• 🔍 Keyword Search – Find markets by topic or keyword

Quick Start

Ready to explore prediction markets? Install in seconds:

Install in Cursor (Recommended):

🔗 Install in Cursor

Or install manually:

npm install -g prediction-markets-mcp
# Or from source:
git clone https://github.com/JamesANZ/prediction-markets-mcp.git
cd prediction-markets-mcp && npm install && npm run build

Features

get-prediction-markets

Search for prediction markets across multiple platforms by keyword.

Parameters:

• keyword (string, required): Search term (max 50 characters)
  • Examples: "trump", "election", "supreme court"

Returns:

• Markets from Polymarket (percentage odds)
• Markets from PredictIt (dollar prices)
• Markets from Kalshi (regulated US markets)

gather-market-movement-evidence

Given one market and a lookback window, return the observed price move and recent external evidence. The server does not decide why the market moved. The calling model does that from the evidence.

Agent Reach is optional. If it is not installed, this tool still returns the market and the price move, and marks external sources unavailable. get-prediction-markets does not call Agent Reach.

Parameters:

• market (string, required): A keyword, or a direct id such as polymarket:<slug>, kalshi:<ticker>, or predictit:<marketId>:<contractId>. A keyword that matches more than one market returns candidates and does not search the web.
• outcome (string, optional): Outcome to measure. Defaults to Yes when that outcome exists.
• lookback (string, optional): 1h, 6h, 24h, 7d, or 30d. Default 24h. PredictIt has no history API, so that venue compares the previous close with the last trade.
• sources (string array, optional): web, x, reddit, and/or youtube. Default is all four.
• queries (string array, optional): Up to three search queries. When set, they replace the generated query. Only the first query is executed.
• limit (number, optional): Maximum evidence items, 1–10. Default 8.

Evidence text is untrusted data. It is returned in evidence[] and is not treated as instructions.

External search uses the Agent Reach 1.5 command table:

• Web: Exa through mcporter
• YouTube: yt-dlp search metadata, not transcripts
• X: twitter search when TWITTER_AUTH_TOKEN and TWITTER_CT0 are set on this server process
• Reddit: rdt, or desktop OpenCLI when rdt is absent

Facebook, Instagram, and GitHub are not searched. Install Agent Reach and run agent-reach doctor on the same machine as this server. A missing login, rate limit, or offline source is reported on that source and does not fail the price lookup.

{
  "tool": "gather-market-movement-evidence",
  "arguments": {
    "market": "polymarket:fed-decision",
    "lookback": "24h",
    "sources": ["web", "youtube"]
  }
}

Installation

Cursor (One-Click)

Click the install link above or use:

cursor://anysphere.cursor-deeplink/mcp/install?name=prediction-markets-mcp&config=eyJwcmVkaWN0aW9uLW1hcmtldHMtbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwicHJlZGljdGlvbi1tYXJrZXRzLW1jcCJdfX0=

Manual Installation

Requirements: Node.js 18+ and npm

# Clone and build
git clone https://github.com/JamesANZ/prediction-markets-mcp.git
cd prediction-markets-mcp
npm install
npm run build

# Run server
node build/index.js

Usage Examples

Search for Markets

Find prediction markets by keyword:

{
  "tool": "get-prediction-markets",
  "arguments": {
    "keyword": "trump"
  }
}

Search Election Markets

Find markets related to elections:

{
  "tool": "get-prediction-markets",
  "arguments": {
    "keyword": "election"
  }
}

Supported Platforms

Platform	Format	Description
Polymarket	Percentage odds	Crypto-based prediction markets
PredictIt	Dollar prices	Traditional prediction markets
Kalshi	Regulated	US-regulated prediction markets

Data Sources

• Polymarket: Gamma search at https://gamma-api.polymarket.com/public-search, with CLOB history at https://clob.polymarket.com/prices-history
• PredictIt: https://www.predictit.org/api/marketdata/all/
• Kalshi: Regulated US prediction markets

Use Cases

• Traders – Monitor odds and prices across platforms
• Researchers – Analyze market sentiment and predictions
• Developers – Build apps with prediction market data
• Analysts – Track political and event probabilities

Technical Details

Built with: Node.js, TypeScript, MCP SDK
Dependencies: @modelcontextprotocol/sdk, superagent, zod
Platforms: macOS, Windows, Linux

Contributing

⭐ If this project helps you, please star it on GitHub! ⭐

Contributions welcome! Please open an issue or submit a pull request.

License

MIT License – see LICENSE file for details.

Support

If you find this project useful, consider supporting it:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f