ModelsAtlas
Explore
Atlas / MCP servers / kukapay / Freqtrade

FreqtradeCAUTION

mcp/kukapay/freqtrade
MCP server by kukapay · Audited 2026-10-07
⚑ Report / re-scanSource ↗

An MCP server that integrates with the Freqtrade cryptocurrency trading bot.

Verdict
CAUTION
Grade
B
Trust score
89 /100
Exposed tools
17 12r · 3w · 2d
Transport
—
License
MIT
Stars
147
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

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:
git clone https://github.com/kukapay/freqtrade-mcp.git
cd freqtrade-mcp
  1. Install Dependencies:

Using pip:

pip install freqtrade-client mcp[cli]

Or with uv (optional):

uv add freqtrade-client "mcp[cli]"
  1. Client Configuration:
"mcpServers": { 
"freqtrade-mcp": { 
"command": "uv", 
"args": [ 
"--directory", "/your/path/to/freqtrade-mcp", 
"run", 
"__main__.py" 
], 
"env": { 
"FREQTRADE_API_URL": "http://127.0.0.1:8080",
"FREQTRADE_USERNAME": "your_username",
"FREQTRADE_PASSWORD": "your_password"
} 
} 
}
  1. Freqtrade Configuration:

Enable the rest API by adding the apiserver section to your configuration and setting apiserver.enabled to true.

Sample configuration:

"api_server": {
"enabled": true,
"listen_ip_address": "127.0.0.1",
"listen_port": 8080,
"verbosity": "error",
"enable_openapi": false,
"jwt_secret_key"
Read from source at commit 999be088be4eOBSERVED · 2026-10-07
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add freqtrade-mcp --env FREQTRADE_PASSWORD=${FREQTRADE_PASSWORD} -- uvx freqtrade-mcp
claude-desktop
{
  "mcpServers": {
    "freqtrade-mcp": {
      "command": "uvx",
      "args": [
        "freqtrade-mcp"
      ],
      "env": {
        "FREQTRADE_PASSWORD": "${FREQTRADE_PASSWORD}"
      }
    }
  }
}
03

Exposed tools (17)

12 read · 3 write · 2 destructive. Blast radius: 2 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
add_blacklistwrite
delete_blacklistdestructive
delete_lockdestructive
fetch_balanceread
fetch_blacklistread
fetch_bot_statusread
fetch_configread
fetch_locksread
fetch_market_dataread
fetch_performanceread
fetch_profitread
fetch_tradesread
fetch_whitelistread
place_traderead
reload_configread
start_botwrite
stop_botwrite
04

Trust audit

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeWARN
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
declared (1 observation(s))
Shell
none-observed
Dependencies
pinned
Secrets in source
none-found

Findings (3)

MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319
__main__.py:11
FREQTRADE_API_URL = os.getenv("FREQTRADE_API_URL", "http://127.0.0.1:8080")
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
delete_blacklist, delete_lock
Why it matters. 2 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
README.md:47
"FREQTRADE_API_URL": "http://127.0.0.1:8080",

Gates applied: no_behavioural_pass.

Audited 2026-10-07 · audit v0.4.1 · source sha 999be088be4efull audit observations/trust-audit/mcp-server/kukapay__freqtrade.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-07999be088be4eCAUTIONB89first audit
06

Questions

What is the Freqtrade MCP server?

An MCP server that integrates with the Freqtrade cryptocurrency trading bot.

What tools does Freqtrade expose?

17 in total: 12 read-only, 3 that write, and 2 that can delete or overwrite (delete_blacklist, delete_lock). Every one is listed on this page with its risk.

Is Freqtrade safe to connect to an agent?

With care. The audit graded it B (89/100) and found 3 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 2 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does Freqtrade need?

It reads FREQTRADE_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How current is this page?

The grade is for one exact copy of the source (999be088be4e), read on 2026-10-07. The repository is watched and re-audited when it changes.

Advertisement