Futuur API MCP Integration
About
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.
Explore
- Market discovery with filters (category, tag, status, ordering)
- Full account access – profile, balances, leaderboard ranking
- Bet simulation and order execution (limit orders)
- Order management – list, cancel open orders
- Wager position tracking and partial selling
- Play money mode for risk‑free testing
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Futuur API MCP IntegrationCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"futuur": {
"command": "npx",
"args": ["-y", "@futuur/futuur-mcp"],
"env": {
"FUTUUR_PUBLIC_KEY": "your_public_key_here",
"FUTUUR_PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Claude Code (CLI) — run once to register the server:
claude mcp add futuur -- npx -y @futuur/futuur-mcp \
-e FUTUUR_PUBLIC_KEY=your_public_key_here \
-e FUTUUR_PRIVATE_KEY=your_private_key_here
Or add to .claude/settings.json under "mcpServers" using the same format as Claude Desktop above.
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"futuur": {
"command": "npx",
"args": ["-y", "@futuur/futuur-mcp"],
"env": {
"FUTUUR_PUBLIC_KEY": "your_public_key_here",
"FUTUUR_PRIVATE_KEY": "your_private_key_here"
}
}
}
}
``
All authenticated requests use HMAC-SHA512 signatures. The server handles this automatically — just provide your public and private keys via environment variables (
FUTUUR_PUBLIC_KEY / FUTUUR_PRIVATE_KEY`).
Public endpoints (events listing, event details) do not require authentication.
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"futuur api mcp integration": {
"Futuur-MCP": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@futuur/futuur-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"Futuur-MCP": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@futuur/futuur-mcp",
"--client",
"claude"
]
}
}Futuur MCP Server
Model Context Protocol (MCP) server for the Futuur prediction markets API. Gives Claude (and any MCP-compatible client) the ability to browse markets, simulate and place bets, manage orders, and track wager positions.
<div align="center">
</div>
---
Quick start (recommended — Smithery)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
