# tradefloor

> tradefloor is an open-source MCP server for finance and payments. Run simulated stock markets that react to your orders and score trading strategies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://docs.tradefloor.dev/mcp-local.html
- **Repository:** https://github.com/simoncoombes/tradefloor
- **MCP Registry name:** io.github.simoncoombes/tradefloor
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tradefloor -- uvx tradefloor
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tradefloor": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tradefloor": {
      "command": "uvx",
      "args": [
        "tradefloor"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tradefloor
