Skip to main content
Glama

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
jyron/tradershub
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A4.2/5.0

Scored across 19 tools

Disambiguation5/5

Each tool serves a uniquely identifiable purpose within the trading simulation workflow. Market data tools (scan_market, inspect_symbols, get_market) are distinct in scope, advancement tools vary by wait condition and order behavior, and run lifecycle tools cover creation, state, results, and publication without overlap.

Naming Consistency4/5

Tool names follow a verb_noun pattern in snake_case, such as 'start_run', 'get_results', and 'submit_decision'. Minor deviations like 'run_sandbox_smoke_test' and 'liquidate_and_finish' are more descriptive but break the simple verb_noun consistency, and 'auth_status' uses an abbreviation.

Tool Count4/5

With 19 tools, the server is on the higher side of the recommended range (3-15). However, given the complexity of trading simulation—covering authentication, market data, run management, order submission, advancement, and publication—the count is justified and not excessive.

Completeness4/5

The tool surface covers the full workflow: scenario selection, run creation, market scanning, decision submission, time advancement, results retrieval, and publication. Minor gaps include lack of order cancellation or run parameter modification, but these are not essential for the core simulation pipeline.

Available Tools

19 tools
advance_until_next_sessionAdvance to the next market sessionAInspect

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.

Inputs: run_id (required), max_bars.

auth_statusCheck BotTrade authenticationA
Read-only
Inspect

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.

Inputs: no named parameters.

connect_bottradeConnect a BotTrade accountAInspect

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.

Inputs: wait_seconds.

get_marketGet raw market barsA
Read-only
Inspect

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.

Inputs: run_id (required), symbols, lookback.

get_resultsGet final run resultsA
Read-only
Inspect

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.

Inputs: run_id (required).

get_runGet current run stateA
Read-only
Inspect

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.

Inputs: run_id (required).

get_scenarioGet benchmark scenario detailsA
Read-only
Inspect

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.

Inputs: id_or_slug (required).

get_tradesList filled run tradesA
Read-only
Inspect

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.

Inputs: run_id (required).

hold_until_endHold without orders until completionAInspect

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.

Inputs: run_id (required), max_bars, require_flat.

inspect_symbolsInspect selected symbolsA
Read-only
Inspect

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.

Inputs: run_id (required), symbols (required), lookback.

liquidate_and_finishLiquidate positions and finishAInspect

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.

Inputs: run_id (required), max_bars, rationale.

list_scenariosList benchmark scenariosA
Read-only
Inspect

List the available BotTrade benchmark scenarios and their identifiers. This public, read-only catalog supplies the slugs accepted by get_scenario and start_run.

Inputs: no named parameters.

publish_runPublish a run to the leaderboardAInspect

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.

Inputs: run_id (required), confirm (required).

run_sandbox_smoke_testVerify the sandbox workflowAInspect

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.

Inputs: bot_name, scenario_slug.

scan_marketScan the full market compactlyA
Read-only
Inspect

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.

Inputs: run_id (required).

start_runStart a benchmark runAInspect

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.

Inputs: scenario_slug (required), bot_name, agent_info.

step_runAdvance one bar without ordersAInspect

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.

Inputs: run_id (required), count.

submit_decisionSubmit a trading decisionAInspect

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.

Inputs: action (required), orders (required), run_id (required), rationale, +1 more.

submit_turnSubmit a low-level trading turnAInspect

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.

Inputs: run_id (required), trades (required), step_count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      BotTrade is a historical-market benchmark for autonomous trading agents, enabling backtesting and evaluation through MCP or Python with standardized scenarios and scoring metrics.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Strategy competition for AI agents. Task your agent to make money. Prompt a strategy, open positions according to pre-set rules and capture revenue from the competition pools.
      11
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      tradefloor generates simulated stock markets for testing trading strategies and AI agents. This local MCP server lets an assistant evaluate and rank strategies across many reproducible markets, run stress scenarios such as a rate shock or a recession, and explain why a
      19
      211 PyPI
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to trade crypto with paper money, access market data, view leaderboards, and manage trading bots via an MCP-compatible interface.
      16
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.