kukapay/freqtrade-mcp

An MCP server that integrates with the Freqtrade cryptocurrency trading bot via its REST API, enabling seamless AI agent interaction for automated trading operation.
For more crypto-related MCP servers, see the Kukapay MCP servers.
Installation
Prerequisites
- **Python 3.13+**: Ensure Python is installed on your system.
- **Freqtrade**: A running Freqtrade instance with the REST API enabled (see Freqtrade Docs).
- **Git**: For cloning the repository.
Steps
1. **Clone the Repository**:
2. **Install Dependencies**:
Using pip:
Or with uv (optional):
3. **Client Configuration**:
4. **Freqtrade Configuration**:
Enable the rest API by adding the api_server section to your configuration and setting api_server.enabled to true.
Sample configuration:
Check the document here.
Usage
Available Tools
The server exposes the following Freqtrade API endpoints as MCP tools:
| Tool | Description | Parameters |
|-----------------------|--------------------------------------|-------------------------------------|
| fetch_market_data | Fetch OHLCV data for a pair | pair: str, timeframe: str |
| fetch_bot_status | Get open trade status | None |
| fetch_profit | Get profit summary | None |
| fetch_balance | Get account balance | None |
| fetch_performance | Get performance metrics | None |
| fetch_whitelist | Get whitelist of pairs | None |
| fetch_blacklist | Get blacklist of pairs | None |
| fetch_trades | Get trade history | None |
| fetch_config | Get bot configuration | None |
| fetch_locks | Get trade locks | None |
| place_trade | Place a buy/sell trade | pair: str, side: str, stake_amount: float |
| start_bot | Start the bot | None |
| stop_bot | Stop the bot | None |
| reload_config | Reload bot configuration | None |
| add_blacklist | Add pair to blacklist | pair: str |
| delete_blacklist | Remove pair from blacklist | pair: str |
| delete_lock | Delete a trade lock | lock_id: int |
Example Prompts
1. **Fetch Market Data**:
- "Show me the hourly price data for BTC/USDT."
- "What’s the 5-minute chart for ETH/BTC like?"
- "Give me the latest candlestick data for XRP/USDT over the past hour."
2. **Fetch Bot Status**:
- "What’s the current status of my open trades?"
- "Are there any active trades right now?"
- "Tell me about the bot’s trading activity at the moment."
3. **Fetch Profit**:
- "How much profit have I made so far?"
- "What’s the total profit summary for the bot?"
- "Can you show me my trading gains?"
4. **Fetch Balance**:
- "What’s my account balance?"
- "How much money do I have in the trading account?"
- "Tell me the current balance of my Freqtrade wallet."
5. **Fetch Performance**:
- "How well has the bot been performing?"
- "What are the performance metrics for my trades?"
- "Show me the trading stats."
6. **Fetch Whitelist**:
- "Which pairs are on the whitelist?"
- "What trading pairs is the bot allowed to use?"
- "List the whitelisted pairs for me."
7. **Fetch Blacklist**:
- "Which pairs are blacklisted?"