Repository avatar
Developer Tools
v0.1.0
active

reamer-research-mcp

io.github.reamerlabs/reamer-research-mcp

Run backtests, Monte Carlo and visual trade diagnostics with the Reamer Research trading engine.

Documentation

Reamer Research MCP server

An MCP server and Claude Code plugin for Reamer Research, a backtesting and live trading engine for Python and C++. Your AI assistant writes a strategy file, backtests it on your bars, reads every closed trade, runs Monte Carlo and opens the run in visual trade diagnostics, all on your own machine.

Works with Claude Code, Claude Desktop, Cursor and any client that speaks MCP over stdio.

Tools

ToolWhat it does
engine_statusFinds the installed engine: version, default settings, Evaluation Mode limits.
api_referenceThe strategy API, order functions and every setting, for writing a strategy.
backtestRuns a strategy file on CSV or .bin bars and returns the summary metrics and a run_id.
closed_tradesEvery round trip of a run, sorted and paged.
monte_carloResamples a run's per-trade returns into loss, ruin and drawdown statistics.
printed_outputEvery value the strategy printed, stamped with its bar's time.
open_trade_diagnosticsOpens the run in visual trade diagnostics: each trade on its own bars, beside every value the strategy printed.

Each backtest runs in its own process under the Python that has the engine, so anything a strategy prints stays out of the MCP connection. Runs are stored in ~/.cache/reamer-research-mcp/runs/ (REAMER_MCP_RUNS moves it), each with the full JSON report and the trade diagnostics page.

Install

1. The engine. Download the Reamer Research kit (free, no key, Linux x86-64, macOS on Apple silicon, Windows through WSL2) from reamerlabs.com/download, then:

tar xzf research-kit-*.tar.gz
pip install research-kit-*/python/reamer_research-*.whl

2. The server, in one of these ways.

Claude Code plugin, which also adds a Reamer Research skill (needs uv):

claude plugin marketplace add reamerlabs/reamer-research-mcp
claude plugin install reamer-research@reamerlabs

Claude Code, server only:

claude mcp add reamer-research -- uvx reamer-research-mcp

Claude Desktop, Cursor and other clients, in the client's MCP config:

{
  "mcpServers": {
    "reamer-research": {
      "command": "uvx",
      "args": ["reamer-research-mcp"]
    }
  }
}

Without uv, pip install reamer-research-mcp and use reamer-research-mcp as the command.

The server finds the engine in REAMER_PYTHON if set, else in its own Python, else in python3 on PATH. If you installed the wheel into a virtual environment, point REAMER_PYTHON at it:

"env": { "REAMER_PYTHON": "/home/you/venv/bin/python" }

The server needs Python 3.10 or later. The engine runs on Python 3.9 or later.

Try it

Ask your assistant:

Write an ATR band reversion strategy for Reamer Research, backtest it on research-kit-4.11.3-linux_x86_64/python/sample_data/SAMPLE_5min.csv with a 0.005 commission and a 0.01 spread, show me the five worst trades and run Monte Carlo.

Evaluation Mode

Without a licence, each backtest runs on one ticker over at most 30 days or 50,000 bars, whichever comes first, and live trading is off. A run past a limit returns an error that names the limit. A Reamer Research licence is $20 per seat per month and removes every limit; the same strategy files run unchanged.

Links

Licence

This server, the plugin and the skill are under the MIT licence. The engine is commercial software under the Reamer Labs Software License Agreement, downloaded separately from reamerlabs.com/download.

Support: support@reamerlabs.com

PYPI
reamer-research-mcp
Install Command
pip install reamer-research-mcp