Skip to main content

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.

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)

Source distribution for reamer-research-mcp 0.1.0
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)

Table of built distributions (wheels) for reamer-research-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page