Skip to content
MCP server

tradefloor

Run simulated stock markets that react to your orders and score trading strategies

Runs locallyStatus and history
Install
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 tradefloor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools