Freqtrade
A read-only MCP server that provides LLMs with introspection data and documentation for the Freqtrade codebase. It enables AI tools to access class signatures, method details, and configuration schemas to assist in writing more reliable trading strat
What is Freqtrade?
Freqtrade is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to read-only mcp server that provides llms with introspection data and documentation for the freqtrade codebase. it enables ai tools to access class signatures, method details, and configuration schemas ...
A read-only MCP server that provides LLMs with introspection data and documentation for the Freqtrade codebase. It enables AI tools to access class signatures, method details, and configuration schemas to assist in writing more reliable trading strat
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A read-only MCP server that provides LLMs with introspection
Use Cases
Maintainer
Works with
Installation
NPM
npx -y freqtradeManual Installation
npx -y freqtradeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Freqtrade
freqtrade-mcp is a read-only MCP server that gives AI assistants live introspection into a running Freqtrade algorithmic trading bot. It exposes 17 tools covering market data retrieval, bot status monitoring, profit and balance queries, trade history, and pair-list management, as well as control actions like starting, stopping, and reloading the bot's configuration. Developers use it to ask natural language questions about their trading strategy performance and to let AI tools assist in writing and debugging Freqtrade strategies.
Prerequisites
- Python 3.10 or later with pip or uv installed
- A running Freqtrade instance with its REST API enabled (api_server.enabled: true in config.json)
- Freqtrade API credentials: a username and password configured in Freqtrade's config
- The freqtrade-client Python package and mcp[cli] package
- An MCP-compatible AI client (Claude Desktop, Cursor, or similar)
Enable Freqtrade's REST API
In your Freqtrade config.json, add an api_server section. This is required for freqtrade-mcp to communicate with your bot.
{
"api_server": {
"enabled": true,
"listen_ip_address": "127.0.0.1",
"listen_port": 8080,
"jwt_secret_key": "your-secret-key-here",
"username": "your_username",
"password": "your_password"
}
}Install dependencies
Install the required Python packages for the MCP server.
pip install freqtrade-client "mcp[cli]"
# Or with uv
uv pip install freqtrade-client "mcp[cli]"Clone the freqtrade-mcp repository
Pull the server source code. There is no published package — you run it directly from the cloned repo.
git clone https://github.com/kukapay/freqtrade-mcp.git
cd freqtrade-mcpConfigure environment variables
Set the three required environment variables that tell the MCP server where your Freqtrade bot is running and how to authenticate.
export FREQTRADE_API_URL="http://127.0.0.1:8080"
export FREQTRADE_USERNAME="your_username"
export FREQTRADE_PASSWORD="your_password"Add to your MCP client config
Register freqtrade-mcp in your client's config file, passing the environment variables inline.
{
"mcpServers": {
"freqtrade": {
"command": "python",
"args": ["/path/to/freqtrade-mcp/server.py"],
"env": {
"FREQTRADE_API_URL": "http://127.0.0.1:8080",
"FREQTRADE_USERNAME": "your_username",
"FREQTRADE_PASSWORD": "your_password"
}
}
}
}Freqtrade Examples
Client configuration
Full MCP config block for Claude Desktop connecting to a local Freqtrade instance.
{
"mcpServers": {
"freqtrade": {
"command": "python",
"args": ["/path/to/freqtrade-mcp/server.py"],
"env": {
"FREQTRADE_API_URL": "http://127.0.0.1:8080",
"FREQTRADE_USERNAME": "freqtrader",
"FREQTRADE_PASSWORD": "SuperSecurePassword"
}
}
}
}Prompts to try
Ask natural language questions about your trading bot. The server maps these to Freqtrade REST API calls.
- "Show me the current profit and loss for all open trades"
- "What is the hourly price data for BTC/USDT over the last 24 hours?"
- "Which pairs are on the blacklist?"
- "Stop the trading bot and then reload its configuration"
- "Show me the performance breakdown by trading pair"Troubleshooting Freqtrade
Authentication error: 401 Unauthorized
Verify that FREQTRADE_USERNAME and FREQTRADE_PASSWORD match exactly what is set in Freqtrade's config.json api_server section. Restart Freqtrade after changing credentials.
Connection refused when connecting to FREQTRADE_API_URL
Confirm Freqtrade is running and that api_server.enabled is true. Check that listen_ip_address is 127.0.0.1 (or 0.0.0.0 for remote access) and listen_port matches your FREQTRADE_API_URL.
place_trade tool returns an error even though the bot is running
The bot must be in an active trading state (not stopped) and have sufficient balance. Use fetch_balance and fetch_bot_status first to confirm the bot is running and has funds.
Frequently Asked Questions about Freqtrade
What is Freqtrade?
Freqtrade is a Model Context Protocol (MCP) server that read-only mcp server that provides llms with introspection data and documentation for the freqtrade codebase. it enables ai tools to access class signatures, method details, and configuration schemas to assist in writing more reliable trading strat It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Freqtrade?
Install via npm with the command: npx -y freqtrade. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Freqtrade?
Freqtrade works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Freqtrade free to use?
Yes, Freqtrade is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Freqtrade Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Freqtrade? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Freqtrade in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Freqtrade?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.