tradefloor
Run simulated stock markets that react to your orders and score trading strategies
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.11.0
- Listing updated
- 3 days ago
About tradefloor
tradefloor is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Real market data cannot show what would have happened had you traded differently. tradefloor computes every price itself from a seed and a list of companies, using a limit order book, fills and a daily economy, so your orders move the price and a running market can be forked to test one change, such as a rate rise, in one branch. Nothing ever reaches a broker.
The local server starts as a subprocess of Claude Code, Claude Desktop, Cursor or VS Code and exposes 22 tools. Strategies are JSON StrategySpec objects, since the server does not accept code. Most tools build a market for one call and discard it; session tools keep one open in memory so a model can send orders, read the outcome and decide again. Every result carries caveats about what it cannot show and a provenance block with version, preset, seed and universe.
One seed is one sample, so rank_strategies runs specs across many seeds with a paired sign test. The engine has a Rust core and a Python API, and the docs have setup pages for CrewAI, LlamaIndex, AutoGen, smolagents, Google ADK and Agno.
Install
Run in a terminal
claude mcp add tradefloor -- uvx tradefloorAdd to claude_desktop_config.json
{
"mcpServers": {
"tradefloor": {
"command": "uvx",
"args": [
"tradefloor"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tradefloor": {
"command": "uvx",
"args": [
"tradefloor"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tradefloor": {
"type": "stdio",
"command": "uvx",
"args": [
"tradefloor"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tradefloor": {
"command": "uvx",
"args": [
"tradefloor"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tradefloor": {
"command": "uvx",
"args": [
"tradefloor"
]
}
}
}Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- describe_simulator
- Says what the simulator is, what it reproduces and its limits.
- validate_strategy
- Checks a StrategySpec.
- evaluate_strategies
- Scores strategies against baselines on one market.
- rank_strategies
- Runs specs across seeds with a paired sign test.
What it does
- Reactive simulated markets
- Orders match against book depth and move prices.
- Forkable worlds
- Branch a market to change one factor and compare outcomes.
- Strategy specs as data
- Scores JSON strategies without running code.
- Multi-seed ranking
- Compares strategies across seeds with a paired sign test.
- Move explanations
- Breaks a price move into factors.
- Provenance and caveats
- Each result lists version, seed and its limits.
Good for
- Score a momentum strategy against buy-and-hold
- Test how an agent behaves after a simulated rate shock
- Let a model trade step by step in a safe sandbox
- Compare strategies across many random markets
- Explain why a simulated price moved
Pricing
Open source
Free to install from PyPI; hosted app is in beta
Prices change. Check docs.tradefloor.dev before you buy.
tradefloor FAQ
Does it trade real money?
No. All markets are simulated and nothing reaches a broker.
Can I send code as a strategy?
No. Strategies are JSON StrategySpec objects.
Does the session survive a restart?
No. A session lives in server memory; saved markets need the hosted app, which is in beta.
What does it need?
Python with the mcp extra, version 2.0 or later of the mcp package.
Is tradefloor free?
Yes. tradefloor is open source, so you can use and self-host it for free.
How do I add tradefloor to Claude Code?
Run this command in your terminal: claude mcp add tradefloor -- uvx tradefloor
What are the best alternatives to tradefloor?
The closest alternatives to tradefloor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to tradefloor

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools