prediction-markets-mcp

A Model Context Protocol (MCP) server that provides real-time prediction market data from multiple platforms. This server allows you to query prediction markets for current odds, prices, and market information through a unified interface.

Supported Platforms

• Polymarket - Crypto-based prediction markets with percentage-based odds

• PredictIt - Traditional prediction markets with dollar-based prices

• Kalshi - Regulated US prediction markets

Features

• Multi-platform Support: Query both crypto and traditional prediction markets

• Real-time Data: Get current odds and prices from live markets

• Keyword Search: Filter markets by specific keywords or topics

• Unified Interface: Consistent data format across different platforms

• Error Handling: Graceful handling of API failures and network issues

• Type Safety: Full TypeScript support with comprehensive type definitions

Installation

Prerequisites

• Node.js (v18 or higher)

• npm or yarn

Setup

1. Clone the repository:

2. Install dependencies:

3. Build the project:

Usage

Running the Server

Start the MCP server:

The server runs on stdio and can be integrated with MCP-compatible clients.

API Endpoints

The server provides a single tool: get-prediction-markets

Parameters

• keyword (string, required): Search term to filter markets

  • Maximum length: 50 characters

  • Examples: "trump", "election", "supreme court"

Example Queries

Response Format

The server returns prediction market data in the following format:

Polymarket Markets

PredictIt Markets

Data Sources

Polymarket API

• Base URL: https://clob.polymarket.com/markets

• Format: JSON

• Odds Display: Percentages (e.g., 65.2%)

• Data: Market questions, active status, token prices

PredictIt API

• Base URL: https://www.predictit.org/api/marketdata/all/

• Format: JSON

• Odds Display: Dollar amounts (e.g., $0.65)

• Data: Market names, contracts, trade prices, status

Development

Project Structure

Key Components

Type Definitions

Core Functions

• getPolymarketPredictionData(): Fetches and processes Polymarket data

• getPredictItMarkets(): Fetches all PredictIt markets

• makeApiRequest(): Handles HTTP requests with proper headers

Building

Testing

To test the server manually:

1. Start the server:

2. Send test requests through an MCP client or test the API endpoints directly.

Troubleshooting

Common Issues

No Markets Found

• Cause: Keyword too specific or no matching markets

• Solution: Try broader keywords or check market availability

• Example: Use "election" instead of "specific candidate name"

Development Setup

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

Code Style

• Use TypeScript for all new code

• Follow existing naming conventions

• Add JSDoc comments for public functions

• Ensure all builds pass before submitting

License

MIT License - see LICENSE file for details

Support

For issues and questions:

1. Check the troubleshooting section

2. Review existing GitHub issues

3. Create a new issue with detailed information