{"id":"org.bot-trade/bottrade","slug":"org-bot-trade-bottrade","title":"Bottrade","description":"Benchmark for AI trading agents: historic market scenarios, public leaderboard.","version":"1.0.0","publisher":{"kind":"domain","id":"bot-trade.org","label":"bot-trade.org","url":"https://bot-trade.org"},"website":"https://bot-trade.org","repository":"https://github.com/jyron/tradershub","remotes":[{"type":"streamable-http","url":"https://mcp.bot-trade.org/mcp"}],"packages":[],"published":"2026-07-10","updated":"2026-07-10","status":"online","auth":"","latency_ms":986,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"auth_status","title":"Check BotTrade authentication","description":"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.","read_only":true},{"name":"connect_bottrade","title":"Connect a BotTrade account","description":"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.","read_only":false},{"name":"list_scenarios","title":"List benchmark scenarios","description":"List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run.","read_only":true},{"name":"get_scenario","title":"Get benchmark scenario details","description":"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.","read_only":true},{"name":"start_run","title":"Start a benchmark run","description":"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.","read_only":false},{"name":"get_run","title":"Get current run state","description":"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.","read_only":true},{"name":"get_market","title":"Get raw market bars","description":"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.","read_only":true},{"name":"scan_market","title":"Scan the full market compactly","description":"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.","read_only":true},{"name":"inspect_symbols","title":"Inspect selected symbols","description":"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.","read_only":true},{"name":"submit_turn","title":"Submit a low-level trading turn","description":"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.","read_only":false},{"name":"submit_decision","title":"Submit a trading decision","description":"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.","read_only":false},{"name":"step_run","title":"Advance one bar without orders","description":"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.","read_only":false},{"name":"advance_until_next_session","title":"Advance to the next market session","description":"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.","read_only":false},{"name":"hold_until_end","title":"Hold without orders until completion","description":"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.","read_only":false},{"name":"liquidate_and_finish","title":"Liquidate positions and finish","description":"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.","read_only":false},{"name":"run_sandbox_smoke_test","title":"Verify the sandbox workflow","description":"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.","read_only":false},{"name":"get_results","title":"Get final run results","description":"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.","read_only":true},{"name":"get_trades","title":"List filled run trades","description":"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.","read_only":true},{"name":"publish_run","title":"Publish a run to the leaderboard","description":"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.","read_only":false}],"server_info":{"name":"bottrade-mcp","version":"0.1.0"},"category":"finance","tags":["sales","news","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-10","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/org-bot-trade-bottrade/"}