Freqtrade-MCP

Control a Freqtrade crypto trading bot through its REST API from any MCP-compatible AI agent.

Unverified

stdio (local)

No auth

Stale

Python

View repo 121

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

pip install freqtrade-client mcp[cli]

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "freqtrade-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/your/path/to/freqtrade-mcp",
        "run",
        "__main__.py"
      ],
      "env": {
        "FREQTRADE_API_URL": "http://127.0.0.1:8080",
        "FREQTRADE_USERNAME": "your_username",
        "FREQTRADE_PASSWORD": "your_password"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Python 3.13+
A running Freqtrade instance with the REST API enabled (api_server.enabled = true)
Git (for cloning the repository)
Freqtrade API URL, username, and password

About Freqtrade-MCP

An MCP server that wraps the Freqtrade cryptocurrency trading bot's REST API as MCP tools, allowing AI agents to read market and account data and execute trading operations against a running Freqtrade instance. It is launched via uv over stdio and authenticates to Freqtrade with an API URL plus username/password supplied through environment variables.

Tools & capabilities (17)

fetch_market_data

Fetch OHLCV data for a pair. Parameters: pair (str), timeframe (str).

fetch_bot_status

Get open trade status. No parameters.

fetch_profit

Get profit summary. No parameters.

fetch_balance

Get account balance. No parameters.

fetch_performance

Get performance metrics. No parameters.

fetch_whitelist

Get whitelist of pairs. No parameters.

fetch_blacklist

Get blacklist of pairs. No parameters.

fetch_trades

Get trade history. No parameters.

fetch_config

Get bot configuration. No parameters.

fetch_locks

Get trade locks. No parameters.

place_trade

Place a buy/sell trade. Parameters: pair (str), side (str), stake_amount (float).

start_bot

Start the bot. No parameters.

stop_bot

Stop the bot. No parameters.

reload_config

Reload bot configuration. No parameters.

add_blacklist

Add a pair to the blacklist. Parameters: pair (str).

delete_blacklist

Remove a pair from the blacklist. Parameters: pair (str).

delete_lock

Delete a trade lock. Parameters: lock_id (int).

What this server can do

Freqtrade-MCP provides tools for these capabilities — tap one to see every MCP server that does the same:

Process payments

When to use it

Ask an AI agent for the latest OHLCV/candlestick data for a trading pair and timeframe
Check open trade status, profit summary, account balance, and performance metrics conversationally
Place buy/sell trades and start, stop, or reload the Freqtrade bot via natural-language prompts
Manage the bot's blacklist and clear trade locks through an agent

Security notes

The server connects to a running Freqtrade instance using FREQTRADE_API_URL, FREQTRADE_USERNAME, and FREQTRADE_PASSWORD environment variables. These credentials control a live trading bot — the exposed tools can place trades and start/stop the bot, so the server should only be granted to trusted agents. The README's sample Freqtrade config binds the REST API to 127.0.0.1; do not expose it publicly.

Freqtrade-MCP FAQ

What do I need running before using this server?

A Freqtrade instance with its REST API enabled. Add an api_server section to your Freqtrade config and set api_server.enabled to true (the README shows a sample with listen_port 8080 bound to 127.0.0.1).

How does the server authenticate to Freqtrade?

Through the FREQTRADE_API_URL, FREQTRADE_USERNAME, and FREQTRADE_PASSWORD environment variables set in the MCP client config, which correspond to your Freqtrade REST API URL and credentials.

How is the server launched?

Via uv over stdio: `uv --directory /your/path/to/freqtrade-mcp run __main__.py`, after cloning the repo and installing the freqtrade-client and mcp[cli] dependencies.

Can it actually execute trades?

Yes. In addition to read-only tools, it exposes place_trade plus start_bot, stop_bot, and reload_config, so it can take live trading actions on the connected Freqtrade bot.

#freqtrade #crypto #trading #trading-bot #cryptocurrency #finance #rest-api

Alternatives to Freqtrade-MCP

Compare all alternatives →

Stripe MCP Server (Agent Toolkit)

Finance & Payments

1.9k

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured

Verified

stdio (local)

API key

TypeScript

12 tools

Updated 1 month agoRepo

Coinbase AgentKit MCP Extension

Finance & Payments

900

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 1 month agoRepo

Alpaca MCP Server

Finance & Payments

820

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified

stdio (local)

API key

Python

12 tools

Updated 1 month agoRepo

Compare Freqtrade-MCP with:

vs Stripe MCP Server (Agent Toolkit)vs Coinbase AgentKit MCP Extension vs Alpaca MCP Server vs MetaTrader MCP Server