FullStack Alpha logo BestAITradingTools.com by FullStack Alpha
Red and green candlestick chart recovering after a pullback on a dark background

Connect Your AI deep dive

Freqtrade MCP Review | Let Claude Talk to Your Crypto Bot, Carefully

Freqtrade MCP logoFreqtrade MCPkukapay/freqtrade-mcp

Freqtrade MCP is a small open-source plug that lets an AI assistant like Claude check on and control a Freqtrade crypto trading bot you already run. You can ask for profit, open trades, and balances in plain English, or tell it to start, stop, or place a trade. The catch: it adds no safety layer of its own, so whether those commands touch real money depends entirely on how your Freqtrade bot is configured.

Think of it as a walkie-talkie between you, your AI assistant, and the trading robot already running in your garage.

FullStack Alpha Editorial Team

Reviewed by Jay Rocco, Chief Editor

What Is Freqtrade MCP and What Does It Actually Do?

GitHub page for Freqtrade MCP (kukapay/freqtrade-mcp)
kukapay/freqtrade-mcp on GitHub · 2026

Freqtrade is one of the best-known free, open-source crypto trading bots, written in Python and supported on exchanges including Binance, Kraken, OKX, Bybit, Gate, Bitget, and Hyperliquid. It already has its own controls: a web dashboard called FreqUI, Telegram commands, and a REST API (a set of web addresses software uses to send it commands). Freqtrade MCP plugs into that REST API.

An MCP server is a plug that lets an AI assistant like Claude read data or use an app. Freqtrade MCP, built by the kukapay developer group, exposes 17 tools. Ten read information: market data, bot status, profit, balance, performance, whitelist, blacklist, trades, config, and locks. Seven take action: place a trade, start the bot, stop the bot, reload the config, add or remove a pair from the blacklist, and delete a lock.

In practice, you can ask "how did the bot do this week and which pairs lost money?" and get an answer drawn from your own bot instead of a guess. You can also say "stop the bot" or "buy 50 USDT of ETH." That second category is where the power and the risk live.

Here is the market truth. The Freqtrade MCP README does not mention dry-run mode at all. Dry run is a Freqtrade setting that trades with fake money against real prices, and the Freqtrade docs recommend starting there. If your bot runs live, an AI-issued place_trade command is a real order. The plug simply passes the message along.

So where does Freqtrade MCP earn its keep? Reporting. A bot throws off a lot of numbers, and most traders stop reading them after week two. Asking Claude for a weekly recap of losing pairs, lock history, and profit by strategy turns that pile into a habit. Habits, not hunches, are what keep a bot honest.

Community Score

45 / 100

How we score
Adoption · How many people starred it
13 / 30
Maintenance · How recently the code was updated
8 / 25
Community sentiment · What traders say on Reddit and Hacker News
8 / 20
Builder activity · How many people built their own copy
5.6 / 15
License clarity · Whether you are clearly allowed to use it
10 / 10

GitHub data checked 2026. Community read: not enough independent discussion yet.

Stars
148
Forks (people who built on it)
41
Written in
Python
License
MIT
Last update
2025-12-06
Markets
Crypto
Skill level
Intermediate

Works with

View kukapay/freqtrade-mcp on GitHub ↗

Is Freqtrade MCP Right for You?

Good fit if you are

  • Existing Freqtrade users who want to check bot status and profit by asking Claude instead of opening FreqUI or Telegram.
  • Strategy tinkerers running Freqtrade in dry-run mode who want an AI to recap performance and blacklist weak pairs during testing.
  • Developers studying how to wrap an existing trading bot's REST API as an MCP server.

Skip it if you are

  • You do not already run Freqtrade. This is an add-on, not a bot.
  • You trade stocks. Freqtrade and this connector are crypto only.
  • You want an AI deciding trades on a live account with no human review. Nothing in this repo stops that from going wrong.

The jargon, in plain English

Freqtrade
A free, open-source Python bot that trades crypto on major exchanges using strategies you write.
MCP server
A plug that lets an AI assistant like Claude read data from, or take actions in, another app.
REST API
A set of web addresses that let other software ask a program for data or send it commands.
Dry-run mode
Freqtrade's paper mode: trading with fake money against real prices.
Whitelist and blacklist
The lists of coin pairs the bot is allowed to trade, and the ones it must avoid.
Lock
A temporary block that stops the bot from trading a pair, often after a loss.
Stake amount
How much money the bot puts into a single trade.

What Do Traders Say About Freqtrade MCP?

We found no Reddit or Hacker News threads specifically about Freqtrade MCP worth citing. The repo has around 150 stars and 40 forks (copies people make to build on), modest numbers next to Freqtrade itself, which is one of the most popular open-source trading bots on GitHub.

The gap makes sense. Most Freqtrade users already control their bots through FreqUI or Telegram, and adding an AI layer is still a niche move. The last code push was December 2025, so it is not abandoned, but it is not busy either. Expect to read the code yourself before trusting it.

What they like

  • Simple, readable Python with a clear list of 17 tools
  • Works through Freqtrade's official REST API rather than hacks
  • Lets you query bot performance in plain English
  • MIT license

What they complain about

  • No relevant community discussion found
  • README never mentions dry-run mode or safety checks
  • Requires Python 3.13 or newer, which some setups lack

How Do You Set Up Freqtrade MCP Safely?

Plain steps, fake money first. Keep your keys in a private settings file, never pasted into the code.
  1. 01Run Freqtrade in dry-run mode firstSet up Freqtrade with dry run enabled so every trade uses fake money. Keep it that way while you test the AI connection.
  2. 02Enable Freqtrade's REST APIAdd an api_server section to your Freqtrade config with enabled set to true, listening on 127.0.0.1 so it is only reachable from your own machine. Replace every placeholder secret, username, and password.
  3. 03Install Python 3.13 and clone the repoFreqtrade MCP requires Python 3.13 or newer. Clone the repo from GitHub and install freqtrade-client and mcp with pip or uv.
  4. 04Put credentials in the client's env settingsIn your AI client's MCP config, set FREQTRADE_API_URL, FREQTRADE_USERNAME, and FREQTRADE_PASSWORD as environment variables. Do not hard-code them in scripts.
  5. 05Test read-only questionsAsk for bot status, profit, and open trades. Confirm the answers match FreqUI before trying any action tools.
  6. 06Decide which actions to allowKeep your AI client's per-tool approval prompts on, especially for place_trade, start_bot, stop_bot, and delete_lock.

What Do You Need to Run Freqtrade MCP?

  • A running Freqtrade bot

    Freqtrade MCP only talks to an existing Freqtrade instance through its REST API.

    Freqtrade
  • A supported crypto exchange account

    Freqtrade needs an exchange to pull prices and, in live mode, place orders. The Freqtrade docs list these among supported exchanges.

    BinanceKrakenOKXBybitGateBitgetHyperliquid
  • An MCP-capable AI client

    The README gives a generic mcpServers config that clients like Claude Desktop accept.

    Claude Desktop
  • Python 3.13 or newer

    The server is Python and its README sets 3.13 as the minimum.

    Python

What Are the Risks of Using Freqtrade MCP?

  • No built-in safety layer

    The README describes no confirmation step, trade size cap, or dry-run check. place_trade sends whatever stake amount the AI passes.

  • Live bot means live orders

    If Freqtrade runs in live mode, AI-issued trades use real money. Dry run is set in Freqtrade, not in this connector.

  • Exposed API is a doorway

    The REST API can start, stop, and trade. Keep it on 127.0.0.1, use strong credentials, and never expose it to the internet.

  • Small project, modest upkeep

    Around 150 stars and a last push in December 2025. If Freqtrade changes its API, fixes may lag.

  • Some exchanges block US users

    Several Freqtrade-supported exchanges, including Bybit, do not serve US residents. Check your exchange's terms before going live.

Not ready to run code yourself? Our hands-on AI stock tool reviews on AIStockPickerApp.com score finished products on five pillars, the AI stock tools directory at AIStockPickerApps.com sorts 200+ tools by the job they do, and AIStockTradingBots.com walks through broker APIs, bot setup and backtesting step by step. Or head back to the Trading Workflows home page to match tools to your own routine and budget.

What Are the Best Freqtrade MCP Alternatives?

Should You Use Freqtrade MCP? Our Verdict

Freqtrade MCP is a neat, honest piece of glue. If you already run Freqtrade, asking Claude "what is my profit and which pairs are dragging?" is faster than clicking through dashboards, and the code is small enough to read in one sitting.

But Freqtrade MCP adds convenience, not judgment. Keep the bot in dry run while you test, leave approval prompts on for every action tool, and treat AI-issued trades as drafts you sign. The bot executes the strategy. The AI answers questions. You stay the risk manager.

Community Score

45

out of 100 · method

More Freqtrade MCP Questions, Answered

What is Freqtrade MCP?

Freqtrade MCP is an open-source MCP server that connects AI assistants like Claude to a running Freqtrade crypto bot through Freqtrade's REST API. It offers 17 tools for checking status and profit and for actions like placing trades or stopping the bot.

Is Freqtrade free?

Yes. Freqtrade is free and open source, and Freqtrade MCP is free under the MIT license. You still pay exchange trading fees on live trades and any cost of your AI client.

Does Freqtrade MCP support dry-run mode?

The Freqtrade MCP README does not mention dry run. Dry run is a setting inside Freqtrade itself, so if your bot runs in dry-run mode, trades sent through the MCP server use simulated money.

Can Freqtrade use AI?

Freqtrade has its own machine learning module called FreqAI for strategy research. Freqtrade MCP is different: it lets a chat assistant like Claude talk to and control your bot, not design its signals.

Does Freqtrade work with stocks?

No. Freqtrade is a crypto trading bot, and its docs list crypto exchanges such as Binance, Kraken, OKX, and Hyperliquid. Freqtrade MCP inherits that crypto-only scope.

Sources we checked

Incoming transmission | Free weekly newsletter

Stop paying for tools that don't earn their seat.

FullStack Alpha has tested 200 AI stock tools. Be honest: how many of yours do the same job, and which one did you forget you signed up for?

One email a week fixes that: which tools are worth the money, what they cost right now, and how the traders on this site wire them into a routine. Five minutes to read. Zero noise.

Free. One email a week. Unsubscribe in one click. We never sell your email.

  • Hot stock picks
  • Paid signal pitches
  • Fake countdown timers
  • Gurus selling courses

Inside every issue

5 MIN READ

  1. 01

    The Verdict

    One AI trading tool tested and scored. What it does well, what it costs, and the catch the sales page leaves out.

  2. 02

    Price Watch

    Price changes and live promos on the tools traders actually use, monthly and annual side by side, so you stop overpaying.

  3. 03

    Workflow Teardown

    One educator's routine taken apart: the scan, the chart, the tools, and the free swap for every paid one.

  4. 04

    Scan of the Week

    Exact scanner settings you can copy, pulled from the educator's own lesson with the timestamp.

Process beats prediction. This is the email that keeps your process honest.

FullStack Alpha logo

FullStack Alpha Network