Futuur API MCP Integration

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…

Local serverstdioISC

What is the Futuur API MCP Integration MCP Server?

Futuur API MCP Integration is an MCP project maintained in the futuur/futuur-mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @futuur/futuur-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares FUTUUR_PUBLIC_KEY, FUTUUR_PRIVATE_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_markets	List/search events with filters (category, tag, status, ordering, etc.)
get_market_details	Full details for a single event including all nested markets
get_categories	List market categories (legacy v1 endpoint)
get_category_details	Details for a specific category
get_price_history	Historical price data for an event (day, week, month, year, all_time)
get_user_profile	Authenticated user profile and balances
get_user_ranking	Your position on the leaderboard
get_bet_simulation	Preview a limit order (cost/shares) without placing it
place_bet	Execute a limit order using a confirmed simulation payload
list_orders	List your open/filled/cancelled orders
cancel_order	Cancel an open order by ID
get_user_bets	List your wager positions with optional filters
get_wager_details	Full details for a single wager
get_partial_sell_amount	Simulate proceeds from selling N shares
sell_bet	Sell all or part of a wager position

How to install the Futuur API MCP Integration MCP Server

{
  "mcpServers": {
    "futuur": {
      "command": "npx",
      "args": [
        "-y",
        "@futuur/futuur-mcp"
      ],
      "env": {
        "FUTUUR_PUBLIC_KEY": "YOUR_FUTUUR_PUBLIC_KEY",
        "FUTUUR_PRIVATE_KEY": "YOUR_FUTUUR_PRIVATE_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
FUTUUR_PUBLIC_KEY	Declared in the maintainer’s client configuration.	Check documentation
FUTUUR_PRIVATE_KEY	Declared in the maintainer’s client configuration.	Check documentation