Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FREQTRADE_API_URL | Yes | URL of the Freqtrade instance with the REST API enabled (e.g., http://127.0.0.1:8080) | http://127.0.0.1:8080 |
| FREQTRADE_PASSWORD | Yes | Password for Freqtrade API authentication | |
| FREQTRADE_USERNAME | Yes | Username for Freqtrade API authentication |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| fetch_market_data | Fetch OHLCV data for a specified trading pair and timeframe. Parameters: pair (str): Trading pair (e.g., "BTC/USDT"). timeframe (str): Timeframe for the data (e.g., "1h", "5m"). ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response containing OHLCV data, or None if failed. |
| fetch_bot_status | Retrieve the current status of open trades. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with open trade status, or None if failed. |
| fetch_profit | Get profit summary for the trading bot. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with profit summary, or None if failed. |
| fetch_balance | Fetch the account balance. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with account balance, or None if failed. |
| fetch_performance | Retrieve trading performance metrics. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with performance metrics, or None if failed. |
| fetch_whitelist | Get the current whitelist of trading pairs. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with whitelist data, or None if failed. |
| fetch_blacklist | Get the current blacklist of trading pairs. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with blacklist data, or None if failed. |
| fetch_trades | Fetch the history of closed trades. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with trade history, or None if failed. |
| fetch_config | Retrieve the current bot configuration. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with configuration data, or None if failed. |
| fetch_locks | Get the current trade locks. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with trade locks data, or None if failed. |
| place_trade | Place a trade (buy or sell) with the specified pair and amount. Parameters: pair (str): Trading pair (e.g., "BTC/USDT"). side (str): Trade direction, either "buy" or "sell". stake_amount (float): Amount to trade in the stake currency. ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with trade result, or error message if failed. |
| start_bot | Start the Freqtrade bot. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response or success message, or error if failed. |
| stop_bot | Stop the Freqtrade bot. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response or success message, or error if failed. |
| reload_config | Reload the bot configuration. Parameters: ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response or success message, or error if failed. |
| add_blacklist | Add a pair to the blacklist. Parameters: pair (str): Trading pair to blacklist (e.g., "ETH/USDT"). ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with updated blacklist, or error if failed. |
| delete_blacklist | Remove a pair from the blacklist. Parameters: pair (str): Trading pair to remove from blacklist (e.g., "ETH/USDT"). ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with updated blacklist, or error if failed. |
| delete_lock | Delete a specific trade lock by ID. Parameters: lock_id (int): ID of the trade lock to delete. ctx (Context): MCP context object for logging and client access. Returns: str: Stringified JSON response with updated locks, or error if failed. |
| run_backtest | Start a REST backtest job. Required fields follow freqtrade REST requirements: strategy and enable_protections. |
| fetch_backtest_status | Get current backtest execution status and latest result payload. |
| fetch_backtest_history | Get backtest result history; optionally filter by filename. |
| abort_backtest | Abort currently running backtest task. |
| reset_backtest | Reset backtest state/result on the API server. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_trade | Generate a prompt to analyze a trading pair's performance. |
| trading_strategy | Generate a prompt for suggesting a trading strategy. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |