Skip to content

JamesANZ/prediction-market-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📊 Prediction Markets MCP Server

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

prediction-market-mcp MCP server

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

About

A simple MCP server that grabs prediction market data from polymarket, PredictIt, & Kalshi.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •