MCP server

Unhedged,
in your chat

Research markets, check your positions, and trade from Claude Code or Codex.

Create an API key Start setup

Connect Unhedged

Node.js 20+
Create a key
claude mcp add unhedged --scope user --transport stdio \
  --env UNHEDGED_API_KEY='ak_your_key_here' \
  -- npx -y @unhedged/mcp

Replace the key placeholder, then run in your terminal.

01 / Setup

Connect your client

01

Create an API key

Start with read access. Add trading permissions when you need them.

Research only

  • market:read
  • portfolio:read
  • bet:read
  • order:read
  • balance:read
Create a key

02

Add to Claude Code

Run this command in your terminal. Replace the key placeholder if you have not entered one above. Node.js 20+ is required for the Unhedged server.

claude mcp add unhedged --scope user --transport stdio \
  --env UNHEDGED_API_KEY='ak_your_key_here' \
  -- npx -y @unhedged/mcp

03

Check the connection

Open a new Claude Code session, type /mcp, and look for unhedged.

claude
Claude Code MCP docs
Check a BTC market in Claude Code

“Find an active BTC Up or Down market using Unhedged MCP. What makes Up win, and when does it close?”

02 / Capabilities

What you can ask

Research

“Which open markets cover the next Counter-Strike major, and what are the implied probabilities?”

search_markets

Portfolio

“Summarise my positions, my available and locked balance, and where my risk is concentrated.”

get_portfolio

Trading

“Buy 50 shares of MLBB finals YES at 62 cents, then show me the fill.”

place_order

Tools behind the answers

12 tools
Explore markets Find live questions, understand the rules, and compare activity. No market scope needed

  • Find markets

    Find active and ended markets by asset, sport, topic, or tag. Request resolved markets for history.

    search_markets Public endpoint

  • Read a market

    Check the outcomes, close time, and resolution rule.

    get_market Public endpoint

  • Compare market activity

    See implied probabilities, volume, and bet activity.

    get_market_stats Public endpoint
Understand your account Review your balance, positions, bets, and open orders. Read scopes on your key

  • Check your balance

    See spendable and locked USD, plus held CC.

    get_balance balance:read

  • Review your positions

    See position exposure, performance, and recent payouts.

    get_portfolio portfolio:read

  • Review your pool bets

    See your pool bets and whether they are open or settled.

    list_bets bet:read

  • Review open orders

    See open order book orders across your account or one market.

    list_orders order:read
Trade and manage orders Place pool bets or order book orders, then cancel open orders. Trading scopes on your key

  • Place a pool bet

    Commit a USD amount to an outcome in a pool market.

    place_bet bet:place

  • Place an order

    Submit a limit, market, stop loss, or take profit order.

    place_order order:place

  • Cancel orders

    Cancel selected orders or all open orders on one market.

    cancel_order order:cancel
Withdraw funds Send CC on Canton or USDC on Ethereum. Separate withdrawal scope

  • Request a withdrawal

    Send funds out as CC on Canton or USDC on Ethereum.

    request_withdrawal balance:withdraw
Market maker terms Check your live fees, rebates, rate limits, and exposure. Market maker role

  • Check market maker terms

    Read your fee tier, rebates, limits, and exposure.

    get_market_maker_profile portfolio:read

03 / Permissions

Choose your permissions

Research only

Read markets, positions, and balances.

  • market:read
  • portfolio:read
  • bet:read
  • order:read
  • balance:read

Research and trading

Read your account, place bets and orders, and cancel open orders.

  • market:read
  • portfolio:read
  • bet:read
  • bet:place
  • order:read
  • order:place
  • order:cancel
  • balance:read

Trading and withdrawals

Trade and send funds out of your account.

  • market:read
  • portfolio:read
  • bet:read
  • bet:place
  • order:read
  • order:place
  • order:cancel
  • balance:read
  • balance:withdraw

Cap the session

UNHEDGED_MAX_SPEND_PER_SESSION caps bet stakes and buy-order amounts in USD. Fees and withdrawals are excluded. The cap resets when the MCP server restarts.

Optional environment variables
UNHEDGED_MAX_SPEND_PER_SESSION Caps bet stakes and buy-order amounts in USD. Excludes fees and withdrawals; resets on restart.

04 / Links

Go deeper

Your account API keys Reference REST API docs Package @unhedged/mcp For agents Agent instructions

Teach it the rules

A guide to sizing, fills, fees, and failed requests.

Open as Markdown