Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.futuur.com/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Node.js 18 or higher

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

Claude Code CLI

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

Futuur API keys

Log in to futuur.com → Settings → API → generate a key pair. You’ll get a public key and a private key.

​
Setup

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

Paste your API keys

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

Copy and run

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

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.
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
ToolWhat it does
get_marketsList and search events with filters — category, tag, status, ordering
get_market_detailsFull details for one event including all outcome markets
get_price_historyHistorical prices for an event (day / week / month / year / all_time)
get_categoriesList available market categories
get_user_profileYour account profile and balances
get_user_rankingYour leaderboard position
get_bet_simulationPreview a buy order — cost and shares — without placing it
place_betExecute a limit order from a confirmed simulation
list_ordersList your open, filled, or cancelled orders
cancel_orderCancel an open order by ID
get_user_betsList your wager positions with filters
get_wager_detailsFull details for one wager
get_partial_sell_amountSimulate how much you’d receive for selling N shares
sell_betSell 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