# Freqtrade Mcp

> A MCP Server with backtesting tool.

- **Type:** MCP server
- **Install:** `agentstack add mcp-unique-li-yuankun-freqtrade-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [unique-Li-yuankun](https://agentstack.voostack.com/s/unique-li-yuankun)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [unique-Li-yuankun](https://github.com/unique-Li-yuankun)
- **Source:** https://github.com/unique-Li-yuankun/freqtrade_mcp

## Install

```sh
agentstack add mcp-unique-li-yuankun-freqtrade-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# FreqTrade MCP

[English](README.md) | [中文](README.zh.md)

---

### 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 name`timeframe`: Timeframe`pairs`: List of trading pairs`timerange`: Time range`userdir`: 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 range`max-open-trades`: Maximum open trades`stake-amount`: Stake per trade`pairs`: List of trading pairs`starting-balance`: Starting balance`strategy-list`: List of strategies to backtest`userdir`: 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 filename`strategy`: Strategy code content`userdir`: User data directory path |
| **upsert-config** | Upload/update configuration file | Upload configuration file (config.json) to user directory | `config`: config.json file content`userdir`: 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**:
```bash
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**
```bash
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**
```json
{
    "mcpServers": {
      "freqtrade_mcp": {
        "url": "http://127.0.0.1:8000"
      }
    }
}
```

- **Claude Code**
```bash
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
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [unique-Li-yuankun](https://github.com/unique-Li-yuankun)
- **Source:** [unique-Li-yuankun/freqtrade_mcp](https://github.com/unique-Li-yuankun/freqtrade_mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-unique-li-yuankun-freqtrade-mcp
- Seller: https://agentstack.voostack.com/s/unique-li-yuankun
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.