# kukapay/freqtrade-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/freqtrade-mcp  
**GitHub Stars:** 141  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-freqtrade-mcp

## Description
An MCP server that integrates with the Freqtrade cryptocurrency trading bot.

## Tools
Capabilities this server exposes over MCP:

- **fetch_market_data** — Fetch OHLCV data for a pair
- **fetch_bot_status** — Get open trade status
- **fetch_profit** — Get profit summary
- **fetch_balance** — Get account balance
- **fetch_performance** — Get performance metrics
- **fetch_whitelist** — Get whitelist of pairs
- **fetch_blacklist** — Get blacklist of pairs
- **fetch_trades** — Get trade history
- **fetch_config** — Get bot configuration
- **fetch_locks** — Get trade locks
- **place_trade** — Place a buy/sell trade
- **start_bot** — Start the bot
- **stop_bot** — Stop the bot
- **reload_config** — Reload bot configuration
- **add_blacklist** — Add pair to blacklist
- **delete_blacklist** — Remove pair from blacklist
- **delete_lock** — Delete a trade lock

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "freqtrade-mcp": {
    "command": "uvx",
    "args": ["freqtrade-client"],
    "env": {
      "FREQTRADE_API_URL": "",
      "FREQTRADE_USERNAME": "",
      "FREQTRADE_PASSWORD": ""
    }
  }
}
```

**Requires environment variables:** `FREQTRADE_API_URL`, `FREQTRADE_USERNAME`, `FREQTRADE_PASSWORD` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What kukapay/freqtrade-mcp MCP server does

kukapay/freqtrade-mcp MCP server connects an MCP client to a running Freqtrade cryptocurrency trading bot. Rather than implementing an exchange connection itself, it calls the bot's REST API and makes selected Freqtrade operations available as MCP tools.

The read-oriented tools cover OHLCV market data, open trade status, profit, account balance, performance, pair whitelists and blacklists, trade history, current configuration, and active trade locks. The server also includes operational tools for starting and stopping the bot, reloading configuration, placing a buy or sell trade, changing the blacklist, and deleting a trade lock.

## How it works

The MCP client launches the local Python project and supplies the Freqtrade API URL, username, and password through environment variables. The Freqtrade instance must already be running, and its REST API must be enabled in the Freqtrade configuration.

Market data requires a trading pair and timeframe. Trade placement requires a pair, a side, and a stake amount. Adding or removing a blacklist entry requires a pair, while deleting a lock requires its integer lock ID. The remaining listed tools take no parameters according to the provided tool definitions.

Because several tools change bot state or place trades, access should be limited to a client and user that are intended to control the configured Freqtrade instance. The material does not describe additional confirmation, permission, or risk-management behavior in this MCP server.

## Setup and configuration

The documented prerequisites are Python 3.13 or newer, Git, and a running Freqtrade installation with REST API support enabled. The repository is installed by cloning it, entering its directory, and installing `freqtrade-client` together with `mcp[cli]` using pip. An optional `uv add` workflow is also documented.

Configure the MCP client with `FREQTRADE_API_URL`, `FREQTRADE_USERNAME`, and `FREQTRADE_PASSWORD`. The example points to a local API at port 8080, but the value must match the reachable Freqtrade REST endpoint and credentials.

Freqtrade itself needs an `api_server` configuration section with `enabled` set to `true`. The example also specifies a listen address, port, JWT secret, username, password, and WebSocket token. The README refers to Freqtrade's REST API documentation for the complete configuration details.

## Tools and capabilities

The available capabilities include:

- Retrieve OHLCV data for a pair and timeframe.
- Inspect open trades, profit, balance, performance, completed trades, configuration, and locks.
- Read the configured whitelist and blacklist.
- Place buy or sell trades with a specified stake amount.
- Start, stop, or reload the Freqtrade bot.
- Add or remove blacklist pairs and delete locks by ID.

The kukapay/freqtrade-mcp MCP server is therefore suited to bot monitoring and direct operational control, provided the connected Freqtrade API is configured and reachable.

_Full upstream README: https://allmcps.com/mcp/kukapay-freqtrade-mcp/readme_