kukapay/freqtrade-mcp

Overview

An MCP server that connects AI agents to the Freqtrade cryptocurrency trading bot. It exposes Freqtrade's trading operations as tools that an agent can call to manage trades, check balances, and retrieve market data.

Best for

Best for
Developers building AI agents that need to interact with a Freqtrade cryptocurrency trading bot

Use cases

• Let an AI agent open and close trades on a Freqtrade bot
• Query portfolio balances and trade history through natural language
• Automate trading strategy adjustments via agent-driven commands

How to use

Install

pip install freqtrade-client mcp[cli]

Tools exposed

• fetch_market_data
• fetch_bot_status
• fetch_profit
• fetch_balance
• fetch_performance
• fetch_whitelist
• fetch_blacklist
• fetch_trades
• fetch_config
• fetch_locks
• place_trade
• start_bot
• stop_bot
• reload_config
• add_blacklist
• delete_blacklist
• delete_lock

Notes

An MCP server that connects AI agents to the Freqtrade cryptocurrency trading bot. It exposes Freqtrade’s trading operations as tools that an agent can call to manage trades, check balances, and retrieve market data.

118 stars on GitHub. Last updated 2025-12-06. Licensed MIT.

Use cases

• Let an AI agent open and close trades on a Freqtrade bot
• Query portfolio balances and trade history through natural language
• Automate trading strategy adjustments via agent-driven commands

Pros

• Bridges AI agents with a real trading bot for automated execution
• Lightweight Python implementation with clear MCP protocol
• Active open source project with growing community adoption

Cons

• Requires a running Freqtrade instance and API access
• Limited to Freqtrade’s supported exchanges and features
• No built-in safety guards for agent-initiated trades

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.