Does kukapay/freqtrade-mcp work with Claude Desktop?

The README shows a generic MCP client configuration but does not specifically mention Claude Desktop.

What environment variables does kukapay/freqtrade-mcp require?

Set `FREQTRADE_API_URL`, `FREQTRADE_USERNAME`, and `FREQTRADE_PASSWORD` so the server can connect to the Freqtrade REST API.

Can kukapay/freqtrade-mcp place trades?

Yes. Its `place_trade` tool accepts a pair, a buy or sell side, and a stake amount.

Freqtrade MCP

freqtradecryptocurrencytradingfinance

Connects AI agents to a Freqtrade bot for market data, account monitoring, and trading operations through its REST API.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "kukapay-freqtrade-mcp": {
      "command": "uvx",
      "args": [
        "freqtrade-client"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

kukapay/freqtrade-mcp MCP server exposes a Freqtrade cryptocurrency trading bot through MCP tools backed by Freqtrade's REST API. It supports market and account queries, bot controls, configuration actions, blacklist management, trade locks, and buy or sell operations. Use it when an MCP-compatible client needs to inspect or operate an existing Freqtrade instance with its REST API enabled. The project requires Python 3.13 or newer and credentials for the configured Freqtrade API.

Use cases

Inspect current Freqtrade balances and open trades

Review OHLCV data for a selected trading pair

Place buy or sell trades through an MCP client

Start, stop, or reload a running trading bot

Key features

Fetches OHLCV market data

Reports balances, profits, performance, and trade history

Controls Freqtrade bot state

Places buy and sell trades

Manages pair blacklists and trade locks

Reads Freqtrade configuration

Capabilities & Tool Schemas (17)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Freqtrade 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

How Freqtrade MCP works

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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

141

Stargazers on the source repository.

Last commit

9mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

3 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Freqtrade MCP

Clone the repository, enter its directory, and install `freqtrade-client` and `mcp[cli]` with pip. Python 3.13 or newer is required.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/kukapay-freqtrade-mcp?style=directory)](https://allmcps.com/mcp/kukapay-freqtrade-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/kukapay-freqtrade-mcp"><img src="https://allmcps.com/api/badge/kukapay-freqtrade-mcp?style=directory" alt="Freqtrade MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

PricingFree

10/10 checks healthy over the last 31d

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools26/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 20d ago via OSV.dev · freqtrade-client (PyPI)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Freqtrade MCP →Install in Claude Desktop Install in Cursor Install in VS Code