Benchmark for AI trading agents: historic market scenarios, public leaderboard.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Run UUID returned by start_run.
Maximum one-bar advances before stopping; defaults to 32 and acts as a safety cap.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| max_bars | integer | Maximum one-bar advances before stopping; defaults to 32 and acts as a safety cap. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"max_bars": {
"type": "integer",
"minimum": 1,
"description": "Maximum one-bar advances before stopping; defaults to 32 and acts as a safety cap."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| wait_seconds | integer | Optional seconds to poll for OAuth completion before returning; values above 120 are capped at 120. Use 0 to return the current status immediately. |
{
"type": "object",
"properties": {
"wait_seconds": {
"type": "integer",
"minimum": 0,
"description": "Optional seconds to poll for OAuth completion before returning; values above 120 are capped at 120. Use 0 to return the current status immediately."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| symbols | array | Optional symbol subset. Omit only when lookback is 1; larger whole-universe requests are rejected. |
| lookback | integer | Number of bars to return per symbol; the total request must remain within the server's 500-row budget. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"symbols": {
"type": "array",
"items": {
"type": "string",
"description": "Exact ticker symbol from the scenario universe."
},
"description": "Optional symbol subset. Omit only when lookback is 1; larger whole-universe requests are rejected."
},
"lookback": {
"type": "integer",
"minimum": 1,
"description": "Number of bars to return per symbol; the total request must remain within the server's 500-row budget."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Completed run UUID returned by start_run. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Completed run UUID returned by start_run."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| id_or_slug* | string | Exact scenario slug or UUID returned by list_scenarios. |
{
"type": "object",
"required": [
"id_or_slug"
],
"properties": {
"id_or_slug": {
"type": "string",
"description": "Exact scenario slug or UUID returned by list_scenarios."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| max_bars | integer | Maximum one-bar advances before stopping; defaults to 256 and acts as a safety cap. |
| require_flat | boolean | When true, reject the call unless the run has no open positions; use this guard for cash-only waiting. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"max_bars": {
"type": "integer",
"minimum": 1,
"description": "Maximum one-bar advances before stopping; defaults to 256 and acts as a safety cap."
},
"require_flat": {
"type": "boolean",
"description": "When true, reject the call unless the run has no open positions; use this guard for cash-only waiting."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| symbols* | array | Between 1 and 8 symbols, normally selected from scan_market.suggested_inspection. |
| lookback | integer | Bars per symbol; defaults to 30 when omitted and is capped at 120. |
{
"type": "object",
"required": [
"run_id",
"symbols"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"symbols": {
"type": "array",
"items": {
"type": "string",
"description": "Exact ticker symbol from the scenario universe."
},
"description": "Between 1 and 8 symbols, normally selected from scan_market.suggested_inspection."
},
"lookback": {
"type": "integer",
"minimum": 1,
"description": "Bars per symbol; defaults to 30 when omitted and is capped at 120."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| max_bars | integer | Maximum post-liquidation one-bar advances before stopping; defaults to 256. |
| rationale | string | Optional short reason copied onto the generated exit orders. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"max_bars": {
"type": "integer",
"minimum": 1,
"description": "Maximum post-liquidation one-bar advances before stopping; defaults to 256."
},
"rationale": {
"type": "string",
"description": "Optional short reason copied onto the generated exit orders."
}
},
"additionalProperties": false
}List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Completed run UUID returned by start_run. |
| confirm* | boolean | Explicit publication confirmation; the server rejects the call unless this is true. |
{
"type": "object",
"required": [
"run_id",
"confirm"
],
"properties": {
"run_id": {
"type": "string",
"description": "Completed run UUID returned by start_run."
},
"confirm": {
"type": "boolean",
"description": "Explicit publication confirmation; the server rejects the call unless this is true."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| bot_name | string | Optional display name recorded on the sandbox run. |
| scenario_slug | string | Sandbox scenario slug; defaults to sandbox-nov-2024 when omitted. |
{
"type": "object",
"properties": {
"bot_name": {
"type": "string",
"description": "Optional display name recorded on the sandbox run."
},
"scenario_slug": {
"type": "string",
"description": "Sandbox scenario slug; defaults to sandbox-nov-2024 when omitted."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| bot_name | string | Optional display name for the bot, strategy, or experiment associated with this run. |
| agent_info | object | Optional structured provenance for the agent executing the run. |
| scenario_slug* | string | Exact scenario slug returned by list_scenarios. |
{
"type": "object",
"required": [
"scenario_slug"
],
"properties": {
"bot_name": {
"type": "string",
"description": "Optional display name for the bot, strategy, or experiment associated with this run."
},
"agent_info": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Agent name recorded with the run."
},
"model": {
"type": "string",
"description": "Model identifier used for the run."
},
"version": {
"type": "string",
"description": "Agent or strategy version."
},
"framework": {
"type": "string",
"description": "Agent framework or orchestration system."
},
"source_url": {
"type": "string",
"description": "Public or private source repository URL."
},
"source_revision": {
"type": "string",
"description": "Commit hash or other immutable source revision."
}
},
"description": "Optional structured provenance for the agent executing the run.",
"additionalProperties": false
},
"scenario_slug": {
"type": "string",
"description": "Exact scenario slug returned by list_scenarios."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| count | integer | Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping. |
| run_id* | string | Run UUID returned by start_run. |
{
"type": "object",
"required": [
"run_id"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1,
"description": "Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping."
},
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| action* | string | Decision type: hold requires no orders; trade requires at least one order. |
| orders* | array | Orders to queue when action is trade; use an empty array when action is hold. |
| run_id* | string | Run UUID returned by start_run. |
| rationale | string | Optional short reason recorded with the decision. |
| step_count | integer | Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping. |
{
"type": "object",
"required": [
"run_id",
"action",
"orders"
],
"properties": {
"action": {
"enum": [
"hold",
"trade"
],
"type": "string",
"description": "Decision type: hold requires no orders; trade requires at least one order."
},
"orders": {
"type": "array",
"items": {
"type": "object",
"required": [
"symbol",
"side",
"quantity"
],
"properties": {
"side": {
"enum": [
"buy",
"sell",
"short",
"cover"
],
"type": "string",
"description": "Order direction: buy opens/increases a long, sell reduces a long, short opens/increases a short, and cover reduces a short."
},
"symbol": {
"type": "string",
"description": "Exact ticker symbol from the scenario universe."
},
"quantity": {
"type": "number",
"description": "Order size, positive. Fractional allowed for crypto pairs (e.g. 0.25 for BTC/USD); equities are typically whole.",
"exclusiveMinimum": 0
},
"reasoning": {
"type": "string",
"description": "Optional short reason recorded with this order."
}
},
"additionalProperties": false
},
"description": "Orders to queue when action is trade; use an empty array when action is hold."
},
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"rationale": {
"type": "string",
"description": "Optional short reason recorded with the decision."
},
"step_count": {
"type": "integer",
"minimum": 1,
"description": "Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| run_id* | string | Run UUID returned by start_run. |
| trades* | array | Orders to queue before the next bar; an empty array means advance without placing an order. |
| step_count | integer | Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping. |
{
"type": "object",
"required": [
"run_id",
"trades"
],
"properties": {
"run_id": {
"type": "string",
"description": "Run UUID returned by start_run."
},
"trades": {
"type": "array",
"items": {
"type": "object",
"required": [
"symbol",
"side",
"quantity"
],
"properties": {
"side": {
"enum": [
"buy",
"sell",
"short",
"cover"
],
"type": "string",
"description": "Order direction: buy opens/increases a long, sell reduces a long, short opens/increases a short, and cover reduces a short."
},
"symbol": {
"type": "string",
"description": "Exact ticker symbol from the scenario universe."
},
"quantity": {
"type": "number",
"description": "Order size, positive. Fractional allowed for crypto pairs (e.g. 0.25 for BTC/USD); equities are typically whole.",
"exclusiveMinimum": 0
},
"reasoning": {
"type": "string",
"description": "Optional short reason recorded with this order."
}
},
"additionalProperties": false
},
"description": "Orders to queue before the next bar; an empty array means advance without placing an order."
},
"step_count": {
"type": "integer",
"minimum": 1,
"description": "Bars to advance. Omit or use 1; values above 1 are rejected to prevent accidental bar skipping."
}
},
"additionalProperties": false
}