Futuur API MCP Integration

Name: Futuur API MCP Integration
Author: futuur

@futuur

About 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. This project provides a robust interface for handling market data, categories, user information, and betting operations.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Futuur-MCP": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@futuur/futuur-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Futuur API MCP Integration?

Futuur API MCP Integration is an MCP server for the Futuur prediction markets API. It allows Claude and any MCP-compatible client to browse markets, simulate and place bets, manage orders, and track wager positions. The server is built with TypeScript and Node.js.

How to use Futuur API MCP Integration?

The recommended installation uses Smithery via a single CLI command for Claude Desktop or Cursor. Manual setup requires generating a public/private key pair from Futuur.com, then configuring the MCP client (Claude Desktop, Claude Code, or Cursor) with environment variables FUTUUR_PUBLIC_KEY and FUTUUR_PRIVATE_KEY. After configuration, restart the client.

Key features of Futuur API MCP Integration

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

Use cases of Futuur API MCP Integration

Browse and search live prediction markets by category or volume
Simulate the cost and shares of a limit order before placing it
Place bets using real or play money currency
Monitor open orders and cancel unwanted ones
Sell all or part of a held wager position

FAQ from Futuur API MCP Integration

How does authentication work?

All authenticated requests use HMAC‑SHA512 signatures. The server handles this automatically – you only need to provide your public and private keys via environment variables. Public endpoints (e.g., listing events) do not require authentication.