Prediction Market MCP

🚀 prediction-markets-mcp

A Model Context Protocol (MCP) server that offers real-time prediction market data from multiple platforms, enabling users to query current odds, prices, and market information via a unified interface.

🚀 Quick Start

To get started with the prediction-markets-mcp server, follow these steps:

1. Ensure you have Node.js (v18 or higher) and npm or yarn installed.
2. Clone the repository and navigate to the project directory.
3. Install the dependencies and build the project.
4. Start the server and begin querying prediction markets.

# Clone the repository
git clone <repository-url>
cd prediction-markets-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
node build/index.js

✨ 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:

git clone <repository-url>
cd prediction-markets-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

💻 Usage Examples

Running the Server

Start the MCP server:

node build/index.js

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

// Search for Trump-related markets
{
  "keyword": "trump"
}

// Search for election markets
{
  "keyword": "election"
}

// Search for Supreme Court markets
{
  "keyword": "supreme court"
}

Response Format

The server returns prediction market data in the following format:

Polymarket Markets

**Polymarket: Will Trump win the 2024 election?**
Yes: 45.2% | No: 54.8%

PredictIt Markets

**PredictIt: Which party will win the 2025 gubernatorial election in Virginia?**
Democratic: 89.0% | Republican: 11.0%

📚 Documentation

Supported Platforms

• Polymarket - Crypto-based prediction markets with percentage-based odds
• PredictIt - Traditional prediction markets with dollar-based prices
• Kalshi - Regulated US prediction 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

🔧 Technical Details

Project Structure

prediction-markets-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Key Components

Type Definitions

// Polymarket types
type Market = {
  question: string;
  active: boolean;
  archived: boolean;
  tokens: Token[];
};

// PredictIt types
type PredictItMarket = {
  id: number;
  name: string;
  shortName: string;
  contracts: PredictItContract[];
  status: string;
};

Core Functions

• getPolymarketPredictionData(): Fetches and processes Polymarket data
• getPredictItMarkets(): Fetches all PredictIt markets
• makeApiRequest(): Handles HTTP requests with proper headers

Building

# Development build
npm run build

# Watch mode (if needed)
npm run dev

Testing

To test the server manually:

1. Start the server:

node build/index.js

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

📄 License

This project is licensed under the MIT License - see the 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.

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.