prediction-market-mcp
A simple MCP server that grabs prediction market data from polymarket, PredictIt, & Kalshi.
Documentation
๐ 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.
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):
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 buildFeatures
`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.jsUsage 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
Frequently asked questions
What is prediction-market-mcp?
prediction-market-mcp is A simple MCP server that grabs prediction market data from polymarket, PredictIt, & Kalshi.
How do I install prediction-market-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is prediction-market-mcp open source?
Yes โ it is hosted on GitHub at https://github.com/JamesANZ/prediction-market-mcp and has 36 stars.
Related MCP tools
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
The go-to web for your AI coding agent โ local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.
MCP Aggregator, Orchestrator, Middleware, Gateway in one docker
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP