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
| Tool | What it does |
|---|---|
engine_status |
Finds the installed engine: version, default settings, Evaluation Mode limits. |
api_reference |
The strategy API, order functions and every setting, for writing a strategy. |
backtest |
Runs a strategy file on CSV or .bin bars and returns the summary metrics and a run_id. |
closed_trades |
Every round trip of a run, sorted and paged. |
monte_carlo |
Resamples a run's per-trade returns into loss, ruin and drawdown statistics. |
printed_output |
Every value the strategy printed, stamped with its bar's time. |
open_trade_diagnostics |
Opens 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
Metadata
Release files for reamer-research-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| reamer_research_mcp-0.1.0.tar.gz | 13.2 kB | Without provenance | Details for reamer_research_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| reamer_research_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for reamer_research_mcp-0.1.0-py3-none-any.whl |
Total release size: 29.7 kB
Release files / reamer_research_mcp-0.1.0.tar.gz
| Download URL | reamer_research_mcp-0.1.0.tar.gz |
|---|---|
| Size | 13.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0ab5b2f089fc02bcaf2fa8c7b864790b6c08899e8ea6f09d9eae8169ef099097
|
|
BLAKE2b-256 checksum How to use checksums |
438c0868ef80c9b8563c5aac704888895676acda1db19b3ceb3f6c026b9638b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / reamer_research_mcp-0.1.0-py3-none-any.whl
| Download URL | reamer_research_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab8a550c5b9b902ca87594d5b69241b0b863722139df673136ee64b511bac1a6
|
|
BLAKE2b-256 checksum How to use checksums |
71455b1581a66b4adb26b471c42291afe797e95ff86bf3e5b2f25885516a0fa7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for reamer-research-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.