Claude (MCP)

The Model Context Protocol (MCP) lets Claude call external tools on your behalf. The Futuur MCP server exposes tools covering market discovery, order placement, position management, and account info — all accessible through natural language. Get connected in under a minute: paste your API keys, copy the claude mcp add command, run it in your terminal, then start a new Claude session. You can say things like:

“Show me the top 10 markets by volume”
“Simulate buying 200 OOM on the Yes outcome of event #1234”
“What are my open positions and how are they performing?”
“Sell 50 shares of my wager on the US election market”

Prerequisites

Node.js 18 or higher

Download from nodejs.org. Verify with node --version.

Claude Code CLI

Install the Claude Code CLI. Verify with claude --version.

Futuur API keys

Setup

Paste your Futuur API keys below, then copy and run the generated command in your terminal.

Paste your API keys

Use the fields above. Keys stay in your browser — they are only embedded in the command you copy.

Copy and run

Paste the claude mcp add command into your terminal and press Enter. Claude registers the Futuur MCP server with your keys.

Start Claude

Open a new Claude Code session (claude) — the Futuur tools are available immediately.

To add the server for a single project only, run the command from that project directory. To add it globally, run it from any directory — Claude stores it in your user config.

Manual JSON config (optional)

If you prefer to edit config files yourself, add this under "mcpServers" in ~/.claude.json (global) or .claude/settings.json (project):

{
  "futuur": {
    "command": "npx",
    "args": ["-y", "@futuur/futuur-mcp"],
    "env": {
      "FUTUUR_PUBLIC_KEY": "your_public_key_here",
      "FUTUUR_PRIVATE_KEY": "your_private_key_here"
    }
  }
}

Available tools

Market discovery

get_markets · get_market_details · get_price_history · get_categories

Account

get_user_profile · get_user_ranking

Trading

get_bet_simulation · place_bet · list_orders · cancel_order

Positions

get_user_bets · get_wager_details · get_partial_sell_amount · sell_bet

Tool	What it does
`get_markets`	List and search events with filters — category, tag, status, ordering
`get_market_details`	Full details for one event including all outcome markets
`get_price_history`	Historical prices for an event (`day` / `week` / `month` / `year` / `all_time`)
`get_categories`	List available market categories
`get_user_profile`	Your account profile and wallet balances (see also `GET /me/balances/`)
`get_user_ranking`	Your leaderboard position
`get_bet_simulation`	Preview a buy order — cost and shares — without placing it
`place_bet`	Execute a limit order from a confirmed simulation
`list_orders`	List your open, filled, or cancelled orders
`cancel_order`	Cancel an open order by ID
`get_user_bets`	List your wager positions with filters
`get_wager_details`	Full details for one wager
`get_partial_sell_amount`	Simulate how much you’d receive for selling N shares
`sell_bet`	Sell all or part of a wager position

Example session

You:    Show me the top 5 prediction markets right now

Claude: [calls get_markets with ordering=-volume, limit=5]
        Here are the top markets by volume: ...

You:    I want to bet 100 OOM that Trump wins. Show me the details first.

Claude: [calls get_market_details for the event]
        The "Trump wins 2026" market is currently priced at 62% (0.62).
        Market ID: 8821, Event ID: 4401.

You:    Simulate buying 100 OOM on the Yes outcome

Claude: [calls get_bet_simulation with event_id=4401, market=8821, amount=100, currency=OOM]
        You'd receive approximately 161 shares at 0.62 each. Total cost: 100 OOM.
        Shall I place the order?

You:    Yes, go ahead

Claude: [calls place_bet with confirmed payload]
        Order placed. ID: 99231, status: filled.

Use currency_mode: "play_money" to practice with OOM (play money) before trading real funds.

GitHub repository

Source code, issues, and contributions

Authentication

How HMAC-SHA512 signing works

Placing a bet

Full step-by-step guide to placing orders via the REST API

API Reference

Browse all available endpoints

Get Started

Core Concepts

Guides

Prerequisites

Setup

Available tools

Market discovery

Account

Trading

Positions

Example session

Links

GitHub repository

Authentication

Placing a bet

API Reference

​Prerequisites

​Setup

​Available tools

Market discovery

Account

Trading

Positions

​Example session

​Links

GitHub repository

Authentication

Placing a bet

API Reference

Prerequisites

Setup

Available tools

Example session

Links