Futuur-MCP
If you are the rightful owner of Futuur-MCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Futuur API MCP Integration is a TypeScript-based server for integrating with the Futuur API using the Model Context Protocol.
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:
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 implementationzod: 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.
License
ISC
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support
For support, please open an issue in the GitHub repository or contact the development team.
