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)

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: https://clob.polymarket.com/markets
• 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