About Freqtrade MCP
Freqtrade MCP is an MCP server published by unique-Li-yuankun in the Developer Tools category: a MCP Server with backtesting tool.
The repository has 4 stars and 1 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/unique-Li-yuankun/freqtrade_mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Freqtrade MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
FreqTrade MCP
Overview
FreqTrade MCP is a cryptocurrency backtesting tool integrated with the Model Context Protocol (MCP).
Quick Start
Write a momentum strategy for user directory lyk, help me backtest it and get trading records.
Tools
| Tool Name | Description | Functionality | Parameters |
|---|---|---|---|
| create-user-dir | Create user directory for storing strategy code and backtest results | Create a new user data directory with folder structure for strategies, configurations, and backtest results | userdir: Relative path of user data directory (e.g., lyk) |
| download-data | Download OHLCV historical data from exchange | Download historical data for specified trading pairs and time range for backtesting | exchange: Exchange nametimeframe: Timeframepairs: List of trading pairstimerange: Time rangeuserdir: User data directory path |
| backtesting | Test strategy using historical data | Backtest specified strategy with historical data, generate trading results and statistics | timeframe: Timeframe (1m,5m,30m,1h,1d)timerange: Data time rangemax-open-trades: Maximum open tradesstake-amount: Stake per tradepairs: List of trading pairsstarting-balance: Starting balancestrategy-list: List of strategies to backtestuserdir: User data directory path |
| backtesting-analysis | Analyze backtest results | Perform in-depth analysis of backtest results, generate detailed statistical reports | userdir: User data directory path |
| upsert-strategy | Upload/update strategy code | Upload Python strategy file to strategies folder in user directory | filename: Strategy filenamestrategy: Strategy code contentuserdir: User data directory path |
| upsert-config | Upload/update configuration file | Upload configuration file (config.json) to user directory | config: config.json file contentuserdir: User data directory path |
| get-backtesting-trades | Get backtest trading data | Get trading data from latest backtest results, return in CSV format | userdir: User data directory path |
Usage
PS: Pre-download executable or compile yourself (https://github.com/unique-Li-yuankun/freqtrade_mcp/releases)
- Windows:
git clone https://github.com/freqtrade/freqtrade.git
Set-ExecutionPolicy -ExecutionPolicy Bypass
cd freqtrade
.\setup.ps1
.\freqtrade_mcp -dir W:\freqtrade -addr localhost:8000
- Linux/MacOS
git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade
./setup.sh -i
./freqtrade_mcp -dir path/to/freqtrade -addr localhost:8000
Configure MCP Server
- Cursor
{
"mcpServers": {
"freqtrade_mcp": {
"url": "http://127.0.0.1:8000"
}
}
}
- Claude Code
Add to current project:
claude mcp add --transport http freqtrade_mcp http://127.0.0.1:8000
Add globally:
claude mcp add --scope user --transport http freqtrade_mcp http://127.0.0.1:8000
README fetched from the repository 5 days ago. The original is authoritative.