traderepublic-mcp

A read-only MCP server for Trade Republic, built on pytr.

Designed as the data backend for the ethical-invest-advisor Claude Cowork plugin, but usable from any MCP client.

Read-only by design

This server intentionally exposes no tool that can place, modify or cancel orders, savings plans, or payouts — even though pytr supports some of these. Analysis in, decisions out: any actual operation is done by the human in the Trade Republic app. Forks that add execution tools operate real money over an unofficial API; think twice.

Related MCP server: ibkr-mcp

⚠️ Unofficial API

Trade Republic has no public API. pytr reverse-engineers the private WebSocket API used by the web app. Using it may violate Trade Republic's Terms of Service, and the API can change without notice. Not affiliated with Trade Republic Bank GmbH. Use at your own risk.

Tools

Install

Requires Python 3.10+.

uv tool install git+https://github.com/tommasolovergine/traderepublic-mcp-py
# or: pipx install git+https://github.com/tommasolovergine/traderepublic-mcp-py

This puts a traderepublic-mcp executable on your PATH (stdio transport). If your MCP client is a GUI app that doesn't inherit your shell PATH, reference the executable by absolute path in its configuration (e.g. ~/.local/bin/traderepublic-mcp).

Login needs an AWS WAF anti-bot token. The server first tries a pure-Python solver; if that fails it falls back to a headless Chromium via Playwright, which needs a one-time setup:

playwright install chromium

MCP client configuration

{
  "mcpServers": {
    "trade-republic": {
      "command": "traderepublic-mcp"
    }
  }
}

Authentication and credential handling

• Login mirrors the TR web app: phone + PIN, then a 4-digit code shown in your Trade Republic app.

• The session cookie is stored by pytr in ~/.pytr/cookies.txt and resumed automatically — 2FA is only needed when the session expires.

• This server never writes your phone/PIN to disk. Only if you explicitly call tr_login with store_credentials=true will pytr store them (plaintext, ~/.pytr/credentials) — convenient but not recommended.

• Never commit anything from ~/.pytr/ anywhere.

Development

git clone https://github.com/tommasolovergine/traderepublic-mcp-py
cd traderepublic-mcp-py
uv sync  # or: pip install -e .

License

MIT