Server data from the Official MCP Registry
Futuur prediction markets: browse events and prices, simulate and place orders, track positions.
About
Futuur prediction markets: browse events and prices, simulate and place orders, track positions.
Security Report
Valid MCP server (1 strong, 2 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry.
10 files analyzed · 2 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: FUTUUR_PUBLIC_KEY
Environment variable: FUTUUR_PRIVATE_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"futuur-mcp": {
"command": "npx",
"args": [
"-y",
"@futuur/futuur-mcp@2.0.1"
],
"env": {
"FUTUUR_PUBLIC_KEY": "your-futuur-public-key-here",
"FUTUUR_PRIVATE_KEY": "your-futuur-private-key-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub 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
The button adds the server with empty keys; fill them in under Cursor Settings → MCP to use account and trading tools.
Claude Desktop
Download futuur.mcpb from the latest release and open it: Claude Desktop installs it as an extension and asks for your API keys (optional).
Claude Code
claude mcp add futuur -e FUTUUR_PUBLIC_KEY=your_public_key -e FUTUUR_PRIVATE_KEY=your_private_key -- npx -y @futuur/futuur-mcp
Any other MCP client (VS Code, Windsurf, Cline, ...), in its mcpServers configuration:
{
"futuur": {
"command": "npx",
"args": ["-y", "@futuur/futuur-mcp"],
"env": {
"FUTUUR_PUBLIC_KEY": "your_public_key",
"FUTUUR_PRIVATE_KEY": "your_private_key"
}
}
}
The server is listed in the official MCP Registry as io.github.futuur/futuur-mcp.
| Variable | Purpose |
|---|---|
FUTUUR_PUBLIC_KEY, FUTUUR_PRIVATE_KEY | API key pair. Optional for browsing, required for account and trading tools. |
FUTUUR_API_BASE_URL | Override the API base URL (default https://api.futuur.com/v2.0/). |
Your keys stay on your machine: the server runs locally over stdio and only talks to the Futuur API.
Tools
Market data (no keys needed):
| Tool | What it does |
|---|---|
get_markets | List and search events, with category, tag, status, date and ordering filters |
get_market_details | One event with all of its markets (outcomes) |
get_price_history | Price history of an event's markets |
get_order_book | Bids and asks for one market |
get_categories, get_category_details | Browse categories |
get_exchange_rates, convert_to_usd, convert_from_usd | Currency rates and indicative conversions |
Account and positions (keys required):
| Tool | What it does |
|---|---|
get_user_profile, get_balances, get_user_ranking | Profile, balances per currency, leaderboard position |
get_user_bets, get_wager_details | Positions and their purchase/sale history |
get_partial_sell_amount | Estimate what a position would sell for |
Trading (keys required; these change your balance):
| Tool | What it does |
|---|---|
get_bet_simulation | Preview a buy or sell against the live order book. Places nothing. |
place_bet | Place a limit or market order |
sell_bet | Sell all or part of a position |
list_orders | Your open and past orders |
cancel_order, cancel_all_orders | Cancel resting orders |
Vocabulary: an event is a question; its markets are the outcomes, each priced between 0 and 1. bid buys and ask sells; long is the Yes side of a market and short is the No side. OOM is play money; USDC, USDT and USD are real money. Real-money trading through the API has to be enabled for your account.
Development
npm install
npm run build
npm test
node scripts/smoke.mjs --live
npm test runs the unit tests with a mocked API. The smoke script starts the built server over stdio, checks the handshake and tool metadata, and with --live makes a few read-only calls to the production API. npm run mcpb builds the Claude Desktop extension into dist/futuur.mcpb. See docs/TROUBLESHOOTING.md for common problems.
Releasing
- Bump
versioninpackage.json,server.json(twice) andmanifest.json;npm testfails if they disagree. - Merge, then push a tag:
git tag v2.0.2 && git push origin v2.0.2.
The Release workflow publishes to npm (when an NPM_TOKEN secret is set; otherwise run npm publish first), to the MCP Registry, and attaches futuur.mcpb to a GitHub release. docs/MARKETPLACES.md tracks the other directories.
License
ISC
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
