kukapay/freqtrade-mcp
Free与 Freqtrade 加密货币交易机器人集成的 MCP 服务器。
FreeFree tier
About kukapay/freqtrade-mcp
freqtrade-mcp is an open-source MCP (Model Context Protocol) server that integrates with the Freqtrade cryptocurrency trading bot via its REST API. It enables AI agents to interact seamlessly with Freqtrade for automated trading operations. The server exposes Freqtrade's API endpoints as MCP tools, allowing agents to fetch market data, manage trades, check profit and balance, control the bot, and modify blacklists. It requires a running Freqtrade instance with REST API enabled and Python 3.13+. Configuration is done via environment variables for API URL, username, and password.
Key Features
Integrates with Freqtrade via REST API for seamless AI agent interaction
Exposes 15+ Freqtrade API endpoints as MCP tools
Tools include fetching market data, bot status, profit, balance, performance, whitelist/blacklist, trade history, config, locks
Allows placing buy/sell trades, starting/stopping bot, reloading config, managing blacklist and locks
Easy configuration via environment variables (API URL, username, password)
Open-source and community-driven on GitHub
Pros & Cons
Pros
- Seamless integration with Freqtrade for AI-driven trading automation
- Wide range of exposed endpoints covering most Freqtrade operations
- Open-source and free to use
- Clear setup instructions and configuration examples provided
- Supports both pip and uv installation methods
Cons
- Requires a running and properly configured Freqtrade instance with REST API enabled
- Requires Python 3.13+ which may not be available on all systems
- Limited to operations exposed by Freqtrade REST API; not a standalone trading solution
Best For
Automated cryptocurrency trading with AI agent orchestrationQuerying real-time market data (OHLCV) for trading pairsMonitoring bot performance and profit summariesManaging trade locks and blacklists programmaticallyEnabling natural language interactions with Freqtrade through LLMs
FAQ
What is freqtrade-mcp?
It is an MCP server that integrates with the Freqtrade cryptocurrency trading bot via its REST API, allowing AI agents to interact with the bot for automated trading operations.
How do I set up freqtrade-mcp?
Clone the repository, install dependencies (Python 3.13+ and freqtrade-client + mcp[cli]), configure environment variables (FREQTRADE_API_URL, FREQTRADE_USERNAME, FREQTRADE_PASSWORD), and ensure your Freqtrade instance has the REST API enabled with api_server.enabled set to true.