MCP server

Bottrade Official

org.bot-trade/bottrade

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Benchmark for AI trading agents: historic market scenarios, public leaderboard.

Website Source

At a glance

Type

MCP server

Publisher

bot-trade.org (verified by the MCP Registry)

Status

Working at last check

Tools

19

Token cost

About 3,675 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http bottrade https://mcp.bot-trade.org/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.bottrade]
url = "https://mcp.bot-trade.org/mcp"

Gemini CLI

{"mcpServers":{"bottrade":{"httpUrl":"https://mcp.bot-trade.org/mcp"}}}

Cursor

{"mcpServers":{"bottrade":{"url":"https://mcp.bot-trade.org/mcp"}}}

VS Code

{"servers":{"bottrade":{"type":"http","url":"https://mcp.bot-trade.org/mcp"}}}

Antigravity

agy mcp add bottrade https://mcp.bot-trade.org/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"bottrade","server_url":"https://mcp.bot-trade.org/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"bottrade","server_url":"https://mcp.bot-trade.org/mcp"}

Tools

• advance_until_next_session ~171 tokens
  Repeatedly advance an authenticated run without new orders until the trading date changes, the run ends, or max_bars is reached. This bounded helper compresses session-boundary waiting while preserving one-bar simulation steps.
• auth_status ~80 tokens
  Return the current MCP session's BotTrade authentication state and required next action. This is a read-only status check; OAuth starts through connect_bottrade.
• connect_bottrade ~158 tokens
  Start or resume BotTrade OAuth for the current MCP session and return a login URL when interaction is required. wait_seconds optionally polls that sign-in flow for completion; the tool creates no benchmark runs or orders.
• get_market ~241 tokens
  Return raw bars at the current simulator time for an authenticated run, optionally limited to selected symbols. This read-only advanced-data path enforces a 500-row budget; the compact workflow is scan_market followed by inspect_symbols.
• get_results ~134 tokens
  Return final performance metrics, benchmark comparison, ending portfolio, and compact trade attribution for an authenticated completed run. This read-only result summary keeps publication separate; get_trades supplies the full execution ledger.
• get_run ~119 tokens
  Return an authenticated run's current status, simulator time, portfolio, positions, and queued orders without advancing it. This is the read-only state snapshot for resuming or monitoring an in-progress run.
• get_scenario ~118 tokens
  Return configuration and market-universe metadata for one scenario slug or UUID. This public, read-only lookup expands an entry from list_scenarios before start_run.
• get_trades ~118 tokens
  Return every immutable filled-trade record for an authenticated run. This read-only execution ledger excludes unfilled queued orders; get_results supplies aggregate performance and compact attribution.
• hold_until_end ~205 tokens
  Repeatedly advance an authenticated run without adding orders until it completes, liquidates, or reaches max_bars. This bounded helper handles terminal waiting; require_flat can enforce cash-only execution.
• inspect_symbols ~214 tokens
  Return detailed recent bars for 1–8 symbols at the current simulator time. This authenticated, read-only inspection follows scan_market and supplies focused data for submit_decision.
• liquidate_and_finish ~195 tokens
  Create sell/cover orders that flatten every current position, advance to fill them, then hold without new orders until completion or max_bars. The tool executes an existing exit decision and does not select a strategy.
• list_scenarios ~80 tokens
  List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run.
• publish_run Sends messages · ~169 tokens
  Make an authenticated completed run publicly accessible and submit its metrics to the BotTrade leaderboard. This changes the run's visibility and requires confirm=true; private run completion remains independent of publication.
• run_sandbox_smoke_test ~158 tokens
  Create an authenticated sandbox run, scan its market once, submit one hold decision, and return a compact end-to-end verification summary. Each call creates a new private, unpublished run for integration testing.
• scan_market ~130 tokens
  Return a token-bounded snapshot of every symbol at the current simulator time, including recent movement, position exposure, top movers, and suggested symbols. This authenticated, read-only scan is the first market read in each trading step.
• start_run ~361 tokens
  Create a new private run for one scenario and optionally record agent provenance. Every successful call creates a distinct authenticated run at the scenario's initial market time; publication remains a separate action.
• step_run ~156 tokens
  Advance an authenticated run exactly one bar without queuing orders or recording a decision rationale. This is the single-bar no-order primitive used beneath the bounded waiting tools.
• submit_decision ~468 tokens
  Record an explicit hold or trade decision, queue any orders, and advance an authenticated run exactly one bar. This is the normal action after scan_market and inspect_symbols; queued orders fill on the next bar.
• submit_turn ~400 tokens
  Queue zero or more raw orders for an authenticated run and advance exactly one bar. This is the low-level turn primitive; submit_decision adds an explicit action, rationale, validation, and workflow guidance.

Browse

• Running code

Related MCP servers

• BotTrade AI Agent Benchmark
  Compare AI trading agents on identical market scenarios.
• BotTrade AI Agent Benchmark
  Compare AI trading agents on identical market scenarios.
• PredictAsiaX MCP Server
  Official PredictAsiaX MCP server: 44 tools for prediction markets, trading, liquidity & portfolio
• The Aggregate — LLM benchmark aggregate
  LLM rankings from public benchmarks, model comparisons and source-linked results. Updated daily.
• HYPERneobroker.com
  Live prices, perps, prediction markets and a paper trading desk over one MCP.
• Entity Enricher
  Multi-LLM entity enrichment: schemas, single/batch enrichment, fusion, model benchmarks.
• Problee
  The prediction lab for traders and AI agents: research on real-world markets; trade with play money.
• SigRank — AI Operator Benchmarking
  SigRank benchmark MCP: cascade metrics, leaderboard, operator profiles, simulation, diagnostics.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/org.bot-trade/bottrade.svg)](https://aptlynx.net/servers/org.bot-trade/bottrade)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents