Connections & Capabilities
Connects To
Capabilities
Quickstart
Install
pip install freqtrade-clientExposed MCP Tools (17)
fetch_market_dataRetrieves OHLCV (Open, High, Low, Close, Volume) data for a specified trading pair and timeframe.
Read-only operation; no modification of system state.
fetch_bot_statusGets the current status of the Freqtrade bot, including open trades and operational state.
Read-only operation; no modification of system state.
fetch_profitRetrieves a summary of the profit generated by the Freqtrade bot.
Read-only operation; no modification of system state.
fetch_balanceGets the current account balance from the Freqtrade bot.
Read-only operation; no modification of system state.
fetch_performanceRetrieves performance metrics for the trading bot.
Read-only operation; no modification of system state.
fetch_whitelistGets the list of trading pairs that the bot is allowed to trade.
Read-only operation; no modification of system state.
fetch_blacklistGets the list of trading pairs that the bot is blocked from trading.
Read-only operation; no modification of system state.
fetch_tradesRetrieves the history of trades executed by the bot.
Read-only operation; no modification of system state.
fetch_configGets the current configuration of the Freqtrade bot.
Read-only operation; no modification of system state.
fetch_locksRetrieves the list of active trade locks.
Read-only operation; no modification of system state.
place_tradePlaces a buy or sell trade for a specified trading pair.
Executes trades, potentially leading to financial gains or losses.
start_botStarts the Freqtrade trading bot.
Starts the bot, which will begin automated trading.
stop_botStops the Freqtrade trading bot.
Stops the bot, halting automated trading.
reload_configReloads the Freqtrade bot's configuration.
Reloads the bot's configuration, potentially changing its behavior.
add_blacklistAdds a trading pair to the blacklist, preventing the bot from trading it.
Modifies the bot's trading behavior by preventing trades on a specific pair.
delete_blacklistRemoves a trading pair from the blacklist, allowing the bot to trade it again.
Modifies the bot's trading behavior by allowing trades on a specific pair.
delete_lockDeletes a trade lock, potentially allowing a trade to execute.
Removes a trade lock, potentially affecting trading behavior.
Safety Assessment
This MCP server provides access to a live trading bot, so caution is warranted. It's relatively safe if Freqtrade's API is secured and credentials are well-managed. The risk is higher if the API is exposed without proper authentication or if the trading strategies are poorly designed, potentially leading to financial losses.
- Requires authentication via username/password for Freqtrade API.
- REST API access limits exposure compared to direct system access.
- Clear separation of concerns between MCP server and Freqtrade bot.
- Provides tools for both read and write operations, enabling a balance of control and automation.
- Exposes Freqtrade API endpoints, potentially allowing unauthorized trading if credentials are compromised.
- No explicit rate limiting mentioned, which could lead to API abuse.
- Reliance on Freqtrade's security; vulnerabilities in Freqtrade could be exploited.
- Secrets (username, password) are passed as environment variables, which may not be the most secure method.
- Potential for financial loss if automated trading decisions are flawed.