Futuur Mcp

Futuur API MCP Integration

Overview

Futuur API MCP Integration is a powerful TypeScript-based server that implements the Model Context Protocol (MCP) for seamless integration with the Futuur API. This project provides a robust interface for handling market data, categories, user information, and betting operations.

Features

🔄 Real-time market data integration
📊 Category management
👤 User profile handling
🎲 Betting operations
📚 Comprehensive documentation resources
🛠️ Modular tool architecture

Prerequisites

Node.js (Latest LTS version recommended)
npm or yarn package manager

Installation

Prerequisites

Install Node.js (LTS version) from nodejs.org
Install one of the following:
- Cursor Editor
- Claude Desktop

Installation Steps

Open your terminal and run one of the following commands based on your editor:

For Claude Desktop:

npx -y @smithery/cli install @futuur/futuur-mcp --client claude

For Cursor:

npx -y @smithery/cli install @futuur/futuur-mcp --client cursor

Manual Installation

If you prefer to install manually:

Clone the repository:

git clone https://github.com/yourusername/futuur-api-mcp.git
cd futuur-api-mcp

Install dependencies:

npm install

Project Structure

futuur-api-mcp/
├── src/
│   ├── tools/          # Tool implementations
│   ├── utils/          # Utility functions
│   └── index.ts        # Main server entry point
├── build/              # Compiled JavaScript output
├── package.json        # Project dependencies
├── package-lock.json   # Dependency lock file
├── tsconfig.json       # TypeScript configuration
└── .env               # Environment variables

Core Components

Market Tools: Handle market-related operations
Category Tools: Manage category data and operations
User Tools: Handle user-related functionality
Bet Tools: Process betting operations

Development

The project uses TypeScript for type safety and better development experience. The server implements the Model Context Protocol (MCP) using the official SDK.

Debug Mode

The server includes a debug mode that can be toggled by setting the DEBUG constant in index.ts. When enabled, it provides detailed logging information.

Dependencies

@modelcontextprotocol/sdk: Core MCP implementation
zod: Runtime type checking and validation

Integration

To integrate the MCP server with Cursor, follow these steps:

Build the project:

npm run build

Run the MCP server using Cursor:

Windows:

cmd /c npx mcprunner FUTUUR_PUBLIC_KEY=*YOUR_FUTUUR_PUBLIC_KEY* FUTUUR_PRIVATE_KEY=*YOUR_FUTUUR_PRIVATE_KEY* -- node C:/webapps/futuur-api-mcp/build/index.js

macOS/Linux:

npx mcprunner FUTUUR_PUBLIC_KEY=*YOUR_FUTUUR_PUBLIC_KEY* FUTUUR_PRIVATE_KEY=*YOUR_FUTUUR_PRIVATE_KEY* -- node C:/webapps/futuur-api-mcp/build/index.js

Make sure to replace *YOUR_FUTUUR_PUBLIC_KEY* and *YOUR_FUTUUR_PRIVATE_KEY* with your actual Futuur API credentials.