Futuur
futuur/futuur-mcp
Futuur prediction markets: browse events and prices, simulate and place orders, track positions.
- GitHub stars
- 1
- tools
- 21
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Nov 12, 2026
Tools
21 toolsPublic tool metadata for what this MCP can expose to an agent.
get_marketsList and search events, with category, tag, status, date and ordering filters
List and search events, with category, tag, status, date and ordering filters
No parameter schema in public metadata yet.
get_market_detailsOne event with all of its markets (outcomes)
One event with all of its markets (outcomes)
No parameter schema in public metadata yet.
get_price_historyPrice history of an event's markets
Price history of an event's markets
No parameter schema in public metadata yet.
get_order_bookBids and asks for one market
Bids and asks for one market
No parameter schema in public metadata yet.
get_categoriesBrowse categories
Browse categories
No parameter schema in public metadata yet.
get_category_detailsBrowse categories
Browse categories
No parameter schema in public metadata yet.
get_exchange_ratesCurrency rates and indicative conversions
Currency rates and indicative conversions
No parameter schema in public metadata yet.
convert_to_usdCurrency rates and indicative conversions
Currency rates and indicative conversions
No parameter schema in public metadata yet.
convert_from_usdCurrency rates and indicative conversions
Currency rates and indicative conversions
No parameter schema in public metadata yet.
get_user_profileProfile, balances per currency, leaderboard position
Profile, balances per currency, leaderboard position
No parameter schema in public metadata yet.
get_balancesProfile, balances per currency, leaderboard position
Profile, balances per currency, leaderboard position
No parameter schema in public metadata yet.
get_user_rankingProfile, balances per currency, leaderboard position
Profile, balances per currency, leaderboard position
No parameter schema in public metadata yet.
get_user_betsPositions and their purchase/sale history
Positions and their purchase/sale history
No parameter schema in public metadata yet.
get_wager_detailsPositions and their purchase/sale history
Positions and their purchase/sale history
No parameter schema in public metadata yet.
get_partial_sell_amountEstimate what a position would sell for
Estimate what a position would sell for
No parameter schema in public metadata yet.
get_bet_simulationPreview a buy or sell against the live order book. Places nothing.
Preview a buy or sell against the live order book. Places nothing.
No parameter schema in public metadata yet.
place_betPlace a limit or market order
Place a limit or market order
No parameter schema in public metadata yet.
sell_betSell all or part of a position
Sell all or part of a position
No parameter schema in public metadata yet.
list_ordersYour open and past orders
Your open and past orders
No parameter schema in public metadata yet.
cancel_orderCancel resting orders
Cancel resting orders
No parameter schema in public metadata yet.
cancel_all_ordersCancel resting orders
Cancel resting orders
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
FUTUUR_PUBLIC_KEYFutuur API public key. Optional for browsing markets; needed for account and trading tools. Create a key pair at futuur.com → Settings → API keys.
FUTUUR_PRIVATE_KEYsecretFutuur API private key. Optional for browsing markets; needed for account and trading tools. Create a key pair at futuur.com → Settings → API keys.
Readme
Futuur MCP server
A Model Context Protocol server for Futuur prediction markets. It lets Claude and other MCP clients browse events and prices, simulate and place orders, and track positions through the Futuur public API (https://api.futuur.com/v2.0/).
- Built on the official MCP TypeScript SDK v2 (
@modelcontextprotocol/server), which implements the 2026-07-28 specification and still serves older clients. - Every tool has a title, typed arguments, structured results and read-only / destructive annotations, so clients can ask for confirmation before anything that moves money.
- Browsing works without credentials. Account and trading tools need your Futuur API keys.
Requirements
- Node.js 20 or newer
- Futuur API keys for account and trading tools: futuur.com → Settings → API keys
Setup
Cursor
Details
- Repository
- github.com/futuur/futuur-mcp
- Website
- futuur.com
- Package
@futuur/futuur-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active