Overview

Freqtrade‑MCP bridges the powerful, rule‑based cryptocurrency trading bot Freqtrade with AI assistants through the Model Context Protocol (MCP). By exposing Freqtrade’s REST API as a set of MCP tools, the server enables an AI agent to inspect market conditions, query bot status, and execute trades without leaving its conversational environment. This eliminates the need for manual command‑line interactions or custom integration scripts, allowing developers to prototype and deploy AI‑driven trading strategies at a fraction of the effort.

The server translates each Freqtrade endpoint into an MCP tool, complete with clear parameter descriptions. For example, retrieves OHLCV data for a specified pair and timeframe, while accepts a trading pair, side, and stake amount to execute a market order. Control tools such as , , and give the AI full lifecycle management of the bot. By representing these actions as first‑class tools, an assistant can orchestrate complex workflows—such as monitoring for a breakout signal, calculating risk parameters, and placing an order—all within a single conversation.

Key capabilities include:

• Real‑time data access: Pull live price bars, account balances, and performance metrics on demand.
• Bot state visibility: Query open trades, locks, and configuration to keep the AI informed of the bot’s current status.
• Full control: Start, stop, and reload the bot, enabling dynamic strategy switching or emergency halts.
• Trade execution: Place buy/sell orders with precise stake amounts, allowing the AI to react instantly to market events.

Typical use cases span from rapid prototyping of algorithmic strategies—where a developer can iterate on logic inside the assistant—to production‑grade automated trading, where the AI continuously monitors multiple pairs, adjusts risk settings, and executes trades based on real‑world signals. The MCP integration also facilitates hybrid approaches: an AI can suggest a strategy, then hand off execution to Freqtrade for reliable order handling and risk management.

For developers already familiar with MCP, Freqtrade‑MCP offers a plug‑and‑play solution that turns an existing Freqtrade deployment into a fully AI‑controlled trading engine. Its straightforward tool set, combined with the robustness of Freqtrade’s backtesting and execution framework, provides a unique advantage: the ability to fuse human‑like reasoning with proven algorithmic trading mechanics in a single, cohesive workflow.