tradefloor
Simulated stock markets that react to your orders: run, fork and score trading agents.
Connector by simoncoombes · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/simoncoombes-tradefloor
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 10 read · 6 write · 2 delete · 1 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 19
Read from the source code; the running server may list different tools.
Read 10 · Look things up without changing anything.
check_envelopecheck_jobdescribe_simulatorevaluate_strategiesexplainexplain_price_movelist_scenariosrank_strategiessession_statevalidate_strategy
Write 6 · Create, change, send or run things.
build_scenariobuild_universerun_stress_scenariosession_forksession_stepstart_job
Delete 2 · Delete, drop, revoke or wipe things.
close_sessionsession_rewind
Not yet classified 1 · We could not tell from the name and description.
open_session
Network hosts it talks to 9
astral.sh· found in codedata.sec.gov· found in codedocs.tradefloor.dev· found in codefred.stlouisfed.org· found in codegithub.com· found in codeglama.ai· found in codequery1.finance.yahoo.com· found in codesh.rustup.rs· found in codetradefloor.dev· found in code
Files it touches
/home/ec2-user/out/cert/cells/cell-pt-v20.json/home/ec2-user/out/cert/cells/cell-pt-v21.json/home/ec2-user/out/cert/cells/cell-SHIPPED.json/home/ec2-user/out/cert/cells504/cell-pt-v20.json/home/ec2-user/out/cert/cells504/cell-pt-v21.json/home/ec2-user/out/cert/cells504/cell-SHIPPED.json/home/ec2-user/out/heldseeds/cells/cell-pt-v20.json/home/ec2-user/out/heldseeds/cells/cell-pt-v21.json/home/ec2-user/out/heldseeds/cells/cell-SHIPPED.json/home/ec2-user/out/heldu/cells/cell-pt-v20.json/home/ec2-user/out/heldu/cells/cell-pt-v21.json/home/ec2-user/out/heldu/cells/cell-SHIPPED.json/home/ec2-user/scripts/longrun/liquidity_crisis_proposed.yml/home/ec2-user/scripts/longrun/recession_proposed.yml/home/ec2-user/src/.venv/lib64/python3.11/site-packages/tradefloor/__init__.py/home/ec2-user/src/.venv/lib64/python3.11/site-packages/tradefloor/_core.abi3.so/home/ec2-user/src/.venv/lib64/python3.11/site-packages/tradefloor/_core.pyi/home/ec2-user/src/.venv/lib64/python3.11/site-packages/tradefloor/scenarios/recession.yml/private/tmp/claude-501/private/tmp/claude-501/-Users-simoncoombes-Dev/1c44b7cb-8427-4fe5-bd5c-53a9ae2ea1f3/scratchpad/Users/simoncoombes/Dev/Users/simoncoombes/Dev/tf-wt-r15/Users/simoncoombes/Dev/tf-wt-r15/.venv/bin/python/Users/simoncoombes/Dev/tradefloor/Users/simoncoombes/Dev/tradefloor-design/Users/simoncoombes/Dev/tradefloor-design/programme/results/ptv19r1/local/Users/simoncoombes/Dev/tradefloor-docs/Users/simoncoombes/Dev/tradefloor-serveC:\\...
Tools (19)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
build_scenarioBuild and preview a custom scenarioAuthor a custom scenario and see what it resolves to before running it. Give a macro PATH as hold, ramp and step instructions in `steps`, or explicit INTERVENTIONS as `shocks` and assumed `transmission`. Returns the resolved document, its fingerprint and any warnings; pass that document to run_stress_scenario as `scenario`. Days count from 0, so an event at day 50 needs a run of at least 51 days. Runs no market.
build_universeBuild and preview a rosterBuild a roster of companies and preview it, either generated from a size and seed (optionally concentrated on chosen sectors) or from explicit instruments you supply. Use it when the default random roster will not do, for example to test one sector or your own companies. Returns a `universe` document that every run tool takes as `universe`, with the roster's fingerprint and any envelope warning. Runs no market.
check_envelopeCheck a question against the realism envelopeCheck whether a question falls inside the range the simulator's realism was measured for, BEFORE running it. Use it whenever a conclusion leans on a horizon longer than a year, on particular statistics, on a sector-concentrated roster, on the size of a scenario's effect or on a preset other than the default. Returns ok or a refusal that names the measurement behind it, and for a named preset that preset's measured record. Runs no market, so it answers at once.
check_jobCheck a background jobCheck a background job started by start_job. Returns its status and, once it has finished, the full result in the same form the direct tool returns. Omit job_id to list every job this server still holds. Changes nothing, so it is safe to poll.
close_sessionClose a market sessioncan change or delete dataClose an open session and free its memory, returning each agent's final portfolio and every order sent on the session's line, which is what re-runs it from open_session. The session and its checkpoints are gone afterwards. Runs no market.
describe_simulatorDescribe the simulatorDescribe what this simulator is, what its realism checks certify, what it cannot do, the caps on every tool and how long a run takes. It also lists every shipped preset with its measured record, says which one the certification covers, lists the shipped populations of background traders with what they were measured to do, and describes market sessions. Call it first, before any other tool. It takes no arguments, runs no market and returns the same text on every call.
evaluate_strategiesEvaluate strategies on one marketDescription is built at runtime.
explainTrace a move to its random drawsDescription is built at runtime.
explain_price_moveExplain a price move by factorDescription is built at runtime.
list_scenariosList scenarios and intervention targetsList the shipped stress scenarios, the scenario constructors and every intervention target, with what each target was measured to reach. Read it before build_scenario or run_stress_scenario: each shipped scenario's first_event_day sets the shortest useful run, and four targets have effects too small to see over a hundred days. Takes no arguments and runs no market.
open_sessionOpen a market sessionDescription is built at runtime.
rank_strategiesRank strategies across many seedsDescription is built at runtime.
run_stress_scenarioRun strategies through a stress scenarioDescription is built at runtime.
session_forkFork a market sessionDescription is built at runtime.
session_rewindRewind a market sessioncan change or delete dataDescription is built at runtime.
Show 4 more tools
session_stateRead a market sessionRead an open session without changing it: the clock, every price, the published macro figures, today's news by name, each agent's portfolio and open orders, and the checkpoints session_rewind can return to. Name tickers to add each one's open, high, low, volume and best bid and ask. It shows what a trader could see and nothing of the simulator's own state. Omit session_id to list the open sessions. Runs no market.
session_stepAdvance a market sessionDescription is built at runtime.
start_jobStart a background simulationDescription is built at runtime.
validate_strategyValidate a strategy specParse and fingerprint one strategy spec WITHOUT running it. Use it to iterate on a spec cheaply before evaluate_strategies or rank_strategies: a grammar error comes back naming the field that was wrong, and a valid spec comes back normalised with its fingerprint. A spec looks like {"signal": {"kind": "momentum", "lookback_days": 1.0}, "portfolio": {"top_k": 5, "gross": 1.0}}. Runs no market.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 22
- Weekly downloads
- 161
- Last commit
- Oct 9, 2026 (19 days ago)
- Last release
- Oct 9, 2026 (19 days ago)
- Last package publish
- Oct 9, 2026 (19 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.simoncoombes/tradefloor- Version
- 0.10.2
- Auth
- No auth
- Packages
- pypi tradefloor
- License
- Apache-2.0
- Repository
- github.com/simoncoombes/tradefloor
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
tradefloor MCP server. Agent Mart. https://agentmart.dev/connectors/simoncoombes-tradefloor (last updated 2026-10-24)