Futuur MCP

🚀 Futuur API MCP Integration

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

🚀 Quick Start

Futuur API MCP Integration is a robust server built on TypeScript, implementing the Model Context Protocol (MCP) to achieve seamless integration with the Futuur API. This project provides a comprehensive interface for handling market data, categories, user information, and betting operations.

✨ Features

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

📦 Installation

Prerequisites

• Node.js (It is recommended to use the latest LTS version)
• npm or yarn package manager

Steps

1. Clone the repository:

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

2. Install dependencies:

npm install

📚 Documentation

Project Structure

futuur-api-mcp/
├── src/
│   ├── tools/          # Tool implementation directory
│   ├── utils/          # Utility function directory
│   └── index.ts        # Server entry file
├── build/              # Compiled JavaScript output
├── package.json        # Project dependency management
├── package-lock.json   # Dependency lock file
├── tsconfig.json       # TypeScript configuration file
└── .env               # Environment variable configuration

Core Components

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

Development Information

This project uses TypeScript to ensure type safety and a better development experience. The server implements the Model Context Protocol (MCP) through the official MCP SDK.

Debug Mode

The server includes a switchable debug mode. You can enable or disable it by setting the DEBUG constant in index.ts. When enabled, detailed log information will be provided.

Dependency Management

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

Integration Steps

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

1. Compile the project:

npm run build

2. Run the MCP server using Cursor:

Windows OS:

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

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

Please replace *YOUR_FUTUUR_PUBLIC_KEY* and *YOUR_FUTUUR_PRIVATE_KEY* with your actual Futuur API credentials.

📄 License

ISC

💡 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

🛠️ Support

If you need support, please open an issue in the GitHub repository or contact the development team for assistance.