An MCP server that integrates with the Freqtrade cryptocurrency trading bot through its REST API, enabling seamless interaction with AI agents for automated trading operations.

Installation

Cloning and Installation

git clone https://github.com/kukapay/freqtrade-mcp.git
cd freqtrade-mcp
pip install freqtrade-client mcp[cli]

With UV

git clone https://github.com/kukapay/freqtrade-mcp.git
cd freqtrade-mcp
uv add freqtrade-client "mcp[cli]"

Configuration

MCP Client Configuration

"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"
    }
  }
}

Available Tools

Tool	Description
fetch_market_data	Retrieve OHLCV data for a trading pair
fetch_bot_status	Retrieve status of open trades
fetch_profit	Retrieve profit summary
fetch_balance	Retrieve account balance
fetch_performance	Retrieve performance metrics
fetch_whitelist	Retrieve whitelist of pairs
fetch_blacklist	Retrieve blacklist of pairs
fetch_trades	Retrieve trade history
fetch_config	Retrieve bot configuration
fetch_locks	Retrieve 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 a pair to the blacklist

Features

• Retrieve real-time market data (OHLCV) for trading pairs
• Monitor bot status and open trades
• Get profit summaries and performance metrics
• Manage account balance and trade history
• Control whitelist/blacklist of trading pairs
• Programmatically place buy/sell trades
• Start/stop bot operations
• Manage trade locks and configuration
• Full integration with Freqtrade REST API

Environment Variables

Required

• FREQTRADE_API_URL - URL endpoint of the Freqtrade REST API
• FREQTRADE_USERNAME - Username for authentication to the Freqtrade API
• FREQTRADE_PASSWORD - Password for authentication to the Freqtrade API

Usage Examples

Show me hourly price data for BTC/USDT

What is the current status of my open trades?

How much profit have I made so far?

What is my account balance?

Buy 0.01 BTC/USDT right now

Notes

Requires a running instance of Freqtrade with REST API enabled. Python 3.13+ is required. Freqtrade should be configured with api_server enabled and proper authentication credentials.