org.bot-trade/bottrade

up checked 2026-11-11T16:37:33.345Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

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

Summary by lookupd

Lets an agent run authenticated trading simulations on historical market scenarios, inspect bars, submit orders, and retrieve results and…

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add bottrade --url https://mcp.bot-trade.org/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (19 tools)

Publisher-provided text

• auth_status 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 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
• list_scenarios List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run.
• get_scenario 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
• start_run 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 i
• get_run Return an authenticated run's current status, simulator time, portfolio, positions, and queued orders without advancing it. This is the read-only state snapshot
• get_market 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
• scan_market Return a token-bounded snapshot of every symbol at the current simulator time, including recent movement, position exposure, top movers, and suggested symbols.
• inspect_symbols Return detailed recent bars for 1–8 symbols at the current simulator time. This authenticated, read-only inspection follows scan_market and supplies focused dat
• submit_turn 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 actio
• submit_decision 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 i
• step_run 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 th
• advance_until_next_session 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
• hold_until_end Repeatedly advance an authenticated run without adding orders until it completes, liquidates, or reaches max_bars. This bounded helper handles terminal waiting;
• liquidate_and_finish 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
• run_sandbox_smoke_test 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 n
• get_results Return final performance metrics, benchmark comparison, ending portfolio, and compact trade attribution for an authenticated completed run. This read-only resul
• get_trades Return every immutable filled-trade record for an authenticated run. This read-only execution ledger excludes unfilled queued orders; get_results supplies aggre
• publish_run Make an authenticated completed run publicly accessible and submit its metrics to the BotTrade leaderboard. This changes the run's visibility and requires confi

Details

• Version: 1.0.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 436 ms
• First indexed: 2026-11-01T10:08:01.935Z
• Last seen in registry: 2026-11-01T10:08:01.935Z
• Repository: https://github.com/jyron/tradershub
• Website: https://bot-trade.org

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/org.bot-trade/bottrade.svg)](https://lookupd.com/servers/org.bot-trade/bottrade)

• 62092 servers
• Last crawl: 2026-11-11T17:17:22.074Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp