Prediction Markets MCP Server

1# 📊 Prediction Markets MCP Server
2 
3> **Real-time prediction market data in your AI workflow.** Get current odds and prices from Polymarket, PredictIt, and Kalshi. No API keys required.
4 
5An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that brings live prediction market data into AI coding environments like Cursor and Claude Desktop.
6 
7[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/JamesANZ/prediction-market-mcp)](https://archestra.ai/mcp-catalog/jamesanz__prediction-market-mcp)
8 
9<a href="https://glama.ai/mcp/servers/@JamesANZ/prediction-market-mcp">
10  <img width="380" height="200" src="https://glama.ai/mcp/servers/@JamesANZ/prediction-market-mcp/badge" alt="prediction-market-mcp MCP server" />
11</a>
12 
13## Why Use Prediction Markets MCP?
14 
15- 🆓 **No API Keys** – Works out of the box, zero configuration
16- 📈 **Multi-Platform** – Polymarket, PredictIt, and Kalshi in one interface
17- ⚡ **Real-time Data** – Current odds and prices from live markets
18- 🎯 **Easy Setup** – One-click install in Cursor or simple manual setup
19- 🔍 **Keyword Search** – Find markets by topic or keyword
20 
21## Quick Start
22 
23Ready to explore prediction markets? Install in seconds:
24 
25**Install in Cursor (Recommended):**
26 
27[🔗 Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=prediction-markets-mcp&config=eyJwcmVkaWN0aW9uLW1hcmtldHMtbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwicHJlZGljdGlvbi1tYXJrZXRzLW1jcCJdfX0=)
28 
29**Or install manually:**
30 
31```bash
32npm install -g prediction-markets-mcp
33# Or from source:
34git clone https://github.com/JamesANZ/prediction-markets-mcp.git
35cd prediction-markets-mcp && npm install && npm run build
36```
37 
38## Features
39 
40### `get-prediction-markets`
41 
42Search for prediction markets across multiple platforms by keyword.
43 
44**Parameters:**
45 
46- `keyword` (string, required): Search term (max 50 characters)
47  - Examples: "trump", "election", "supreme court"
48 
49**Returns:**
50 
51- Markets from Polymarket (percentage odds)
52- Markets from PredictIt (dollar prices)
53- Markets from Kalshi (regulated US markets)
54 
55## Installation
56 
57### Cursor (One-Click)
58 
59Click the install link above or use:
60 
61```
62cursor://anysphere.cursor-deeplink/mcp/install?name=prediction-markets-mcp&config=eyJwcmVkaWN0aW9uLW1hcmtldHMtbWNwIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwicHJlZGljdGlvbi1tYXJrZXRzLW1jcCJdfX0=
63```
64 
65### Manual Installation
66 
67**Requirements:** Node.js 18+ and npm
68 
69```bash
70# Clone and build
71git clone https://github.com/JamesANZ/prediction-markets-mcp.git
72cd prediction-markets-mcp
73npm install
74npm run build
75 
76# Run server
77node build/index.js
78```
79 
80## Usage Examples
81 
82### Search for Markets
83 
84Find prediction markets by keyword:
85 
86```json
87{
88  "tool": "get-prediction-markets",
89  "arguments": {
90    "keyword": "trump"
91  }
92}
93```
94 
95### Search Election Markets
96 
97Find markets related to elections:
98 
99```json
100{
101  "tool": "get-prediction-markets",
102  "arguments": {
103    "keyword": "election"
104  }
105}
106```
107 
108## Supported Platforms
109 
110| Platform       | Format          | Description                     |
111| -------------- | --------------- | ------------------------------- |
112| **Polymarket** | Percentage odds | Crypto-based prediction markets |
113| **PredictIt**  | Dollar prices   | Traditional prediction markets  |
114| **Kalshi**     | Regulated       | US-regulated prediction markets |
115 
116## Data Sources
117 
118- **Polymarket**: `https://clob.polymarket.com/markets`
119- **PredictIt**: `https://www.predictit.org/api/marketdata/all/`
120- **Kalshi**: Regulated US prediction markets
121 
122## Use Cases
123 
124- **Traders** – Monitor odds and prices across platforms
125- **Researchers** – Analyze market sentiment and predictions
126- **Developers** – Build apps with prediction market data
127- **Analysts** – Track political and event probabilities
128 
129## Technical Details
130 
131**Built with:** Node.js, TypeScript, MCP SDK  
132**Dependencies:** `@modelcontextprotocol/sdk`, `superagent`, `zod`  
133**Platforms:** macOS, Windows, Linux
134 
135## Contributing
136 
137⭐ **If this project helps you, please star it on GitHub!** ⭐
138 
139Contributions welcome! Please open an issue or submit a pull request.
140 
141## License
142 
143MIT License – see LICENSE file for details.
144 
145## Support
146 
147If you find this project useful, consider supporting it:
148 
149**⚡ Lightning Network**
150 
151```
152lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa
153```
154 
155**₿ Bitcoin**: [bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp](https://mempool.space/address/bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp)
156 
157**Ξ Ethereum/EVM**: [0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f](https://etherscan.io/address/0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f)
158