Income Screener MCP-Server

Ein Python MCP-Server, der Claude über pyetrade für einkommensorientierte Handelsrecherchen mit E*Trade verbindet:

• Echtzeitkurse (Aktien, Vorzugsaktien, Baby Bonds)

• Abfrage von Optionsketten

• Screening von Put-Verkaufs-Kandidaten mit Filtern für die annualisierte Rendite

• Überwachung von Portfolio-Positionen

Architektur

Claude (Claude Code / Claude Desktop)
    ↓ MCP protocol (stdio)
server.py  (FastMCP + pyetrade)
    ↓ OAuth1 REST
E*Trade API (api.etrade.com)

Voraussetzungen

1. Ein aktives E*Trade-Brokerkonto.

2. Entwickler-API-Schlüssel von developer.etrade.com. Die Genehmigung von Produktionsschlüsseln dauert 3–5 Werktage.

3. Python 3.10+.

Einrichtung

pip install -r requirements.txt
cp .env.example .env
# edit .env and set ETRADE_CONSUMER_KEY / ETRADE_CONSUMER_SECRET
python auth.py

auth.py führt durch den OAuth1-Prozess: Es wird eine URL ausgegeben (und versucht, Ihren Browser zu öffnen), Sie autorisieren die App auf der E*Trade-Website, fügen den Verifizierungscode wieder in das Terminal ein, und die resultierenden Zugriffstoken werden in .env geschrieben.

Hinweis: E*Trade-Zugriffstoken laufen um Mitternacht ET ab. Führen Sie python auth.py jeden Morgen erneut aus, bevor Sie den Server verwenden.

Ausführen des Servers

python server.py

Der Server spricht MCP über stdio und ist dafür konzipiert, von einem MCP-Client (Claude Desktop, Claude Code usw.) gestartet zu werden, anstatt interaktiv ausgeführt zu werden.

Claude Desktop-Konfiguration

Hinzufügen zu claude_desktop_config.json:

{
  "mcpServers": {
    "income-screener": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "/home/amahpour/code/pyetrade-mcp"
    }
  }
}

Tools

Annualisierte Rendite

screen_put_candidates berechnet (bid / strike) * (365 / DTE) und filtert nach min_annual_yield. Die Ergebnisse werden nach der höchsten Rendite sortiert.

Standard-Beobachtungslisten

Wenn Sie screen_put_candidates ohne symbols aufrufen, wird eine integrierte Aktienliste verwendet (HPQ, HPE, PFE, T, VZ, F, INTC, DOW, KHC, WBA). Eine Beobachtungsliste für Vorzugsaktien/Baby-Bonds ist in server.py für die Verwendung mit get_quote definiert.

Hinweise

• server.py verwendet dev=False (Produktions-API). Die Sandbox von E*Trade liefert keine echten Optionskettendaten.

• Die Formatierung von Symbolen für Vorzugsaktien (z. B. JPM-C vs JPMpC) kann variieren; testen Sie dies mit Ihren spezifischen Ticker-Symbolen.

• Aufrufe in screen_put_candidates werden mit einer Verzögerung von 0,5 s serialisiert, um die Ratenbegrenzungen von E*Trade einzuhalten.

Dateien

.
├── README.md
├── LICENSE
├── requirements.txt    # pyetrade, mcp[cli], python-dotenv
├── .env.example        # template — copy to .env and fill in
├── auth.py             # one-shot OAuth token refresh
└── server.py           # FastMCP server + all 5 tools