/ Verzeichnis / Playground / SEC EDGAR MCP
● Community stefanoamorelli ⚡ Sofort

SEC EDGAR MCP

von stefanoamorelli · stefanoamorelli/sec-edgar-mcp

Fundierte US-Anmeldungen immer zur Hand Ihres Agenten – CIK-Suche, 10-K/10-Q/8-K, XBRL-Finanzdaten, Form 3/4/5 Insidergeschäfte, jede Antwort kann mit der SEC-Quelle verlinkt werden.

sec-edgar-mcp ermöglicht Agenten strukturierten Zugriff auf das EDGAR-System der SEC. Es löst Unternehmen nach Börsenkürzel oder Namen an CIK auf, ruft bestimmte Einreichungen ab (10-K, 10-Q, 8-K), extrahiert Abschnitte, analysiert XBRL in Bilanz, Gewinn- und Verlustrechnung/Cashflow und zeigt Insiderhandel an (Formular 3/4/5). Jede Antwort enthält SEC-URLs, sodass Sie die Nummer selbst überprüfen können. Nur öffentliche Daten – außer einem konformen Benutzeragenten ist kein API-Schlüssel erforderlich.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

sec-edgar-mcp.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: SEC EDGAR MCP

Führen Sie eine schnelle 10-K-Lektüre mit genauen Zahlen und Zitaten durch

👤 Analysten, Investoren, Journalisten, die über börsennotierte Unternehmen berichten ⏱ ~30 min intermediate

Wann einsetzen: Sie müssen heute Nachmittag einen 10-K-Wert lesen, nicht diese Woche.

Voraussetzungen
  • SEC_EDGAR_USER_AGENT wird mit Ihrem Namen und Ihrer E-Mail-Adresse festgelegt — SEC erfordert einen kontaktierbaren Benutzeragenten für den programmgesteuerten Zugriff
Ablauf
  1. Lösen Sie das Unternehmen auf
    Suchen Sie nach dem CIK für Microsoft.✓ Kopiert
    → CIK 0000789019 zurückgegeben
  2. Ziehen Sie die neuesten 10-K
    Holen Sie sich das neueste 10-K und extrahieren Sie den Abschnitt „Risikofaktoren“.✓ Kopiert
    → Der Abschnitt „Risikofaktoren“ wird mit der Anmelde-URL zurückgegeben
  3. Ziehen Sie die Zahlen
    Extrahieren Sie die Bilanz und die Gewinn- und Verlustrechnung für das Geschäftsjahr 2025.✓ Kopiert
    → Bereinigen Sie die Zeilen mit Werten + Einheiten + Ablage-URL

Ergebnis: Eine leicht verdauliche 10-K-Lektüre mit überprüfbaren Links zurück zu EDGAR.

Fallstricke
  • Verwirrende Geschäftsjahre und Kalenderjahre — Drucken Sie in der Antwort immer den Geschäftsjahreszeitraum aus, damit Benutzer die Plausibilität überprüfen können
Kombinieren mit: yahoo-finance

Verfolgen Sie Insidertransaktionen für eine Beobachtungsliste

👤 Anleger folgen Insider-Stimmung ⏱ ~20 min intermediate

Wann einsetzen: Sie möchten für Ihre Beobachtungsliste täglich einen Überblick über die Form 4-Aktivitäten erhalten.

Ablauf
  1. Listen Sie Insider für jeden Ticker auf
    Für AAPL, MSFT, NVDA – Pull-Form-4-Transaktionen in den letzten 30 Tagen.✓ Kopiert
    → Zeilen mit Insider-Namen, Rolle, Kauf/Verkauf, Aktien, Preis, Datum
  2. Aggregat
    Fassen Sie die Netto-Insiderkäufe und -verkäufe pro Ticker zusammen.✓ Kopiert
    → Eine Zeile pro Ticker mit Nettorichtung

Ergebnis: Ein knackiges Insider-Briefing, ohne EDGAR mit der Hand abzukratzen.

Fallstricke
  • Optionsbezogene Transaktionen als „Käufe“ zählen — Transaktionscodes filtern; P/S vs. A/M/D sind wichtig
Kombinieren mit: alpaca

Fassen Sie die heutigen 8-K-Einreichungen auf einer Beobachtungsliste zusammen

👤 Nachrichtenredaktionen, Unternehmensentwicklungsteams, Investor Relations ⏱ ~10 min beginner

Wann einsetzen: Etwas Wesentliches ist passiert; Sie möchten schnell die verständliche Zusammenfassung.

Ablauf
  1. Ziehen Sie die letzten 8-Ks
    Ziehen Sie die heutigen 8-K-Einreichungen für Ticker in meine Beobachtungsliste.✓ Kopiert
    → Pro Einreichung: Artikelcodes + Link
  2. Zusammenfassen
    Für jeden eine Zusammenfassung in einfacher englischer Sprache mit einem Satz und dem Artikelcode.✓ Kopiert
    → Übersichtliche Zusammenfassung mit der SEC-URL

Ergebnis: Eine Zusammenfassung der Beobachtungsliste, der Sie vertrauen und die Sie verlinken können.

Kombinieren mit: fetch

Vergleichen Sie die Finanzdaten zweier Unternehmen nebeneinander

👤 Aktienanalysten, Studenten bauen Modelle ⏱ ~20 min intermediate

Wann einsetzen: Sie benötigen einen schnellen Vergleich von Äpfeln zu Äpfeln.

Ablauf
  1. Rufen Sie das XBRL beider Unternehmen ab
    Erhalten Sie Umsatz, Bruttogewinn, Betriebseinkommen und Nettoeinkommen für AAPL und MSFT für das Geschäftsjahr 2024.✓ Kopiert
    → Ausgerichtete Tabelle mit Einheiten und Ablage-URLs
  2. Differenzieren Sie die Ränder
    Berechnen und vergleichen Sie Brutto- und Betriebsmargen.✓ Kopiert
    → Ränder nebeneinander; Link zu jeder Einreichung

Ergebnis: Ein vertretbarer Vergleich mit genauen Quell-URLs.

Kombinieren mit: antv-chart

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

sec-edgar-mcp + yahoo-finance

Kombinieren Sie die SEC-Grundlagen mit den aktuellen Marktkursen

Ziehen Sie den neuesten 10-K-Nettogewinn von MSFT und die heutige Marktkapitalisierung heran; Berechnen Sie implizite Vielfache.✓ Kopiert
sec-edgar-mcp + alpaca

Nutzen Sie Insidersignale als Schutzschild

Listen Sie für Ticker mit Netto-Insiderkäufen in den letzten 30 Tagen die aktuellen Preise von Alpaca auf.✓ Kopiert
sec-edgar-mcp + antv-chart

Zeichnen Sie die extrahierten XBRL-Zahlen grafisch auf

Ziehen Sie den Umsatz von 5 Jahren heran und zeichnen Sie ihn mit antv-chart auf.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
lookup_cik ticker_or_name: str Der erste Schritt für jede Unternehmensanfrage 1 SEC request
get_company_facts cik: str Entdecken Sie, welche Werbebuchungen gemeldet werden 1 SEC request
get_filings cik: str, form_type: str, limit?: int Ziehen Sie 10-K-/10-Q-/8-K-Ablagen 1 SEC request
extract_section accession_number: str, section: str Lesen Sie einen bestimmten Abschnitt (z. B. Risikofaktoren, MD&A) 1 SEC request
get_financials cik: str, period: str Strukturierter Jahresabschluss mit Einheiten 1 SEC request
get_insider_transactions cik: str, days?: int Form 3/4/5 Aktivität 1 SEC request

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
SEC-Ratenlimit: ~10 Anfragen/Sek. pro IP – respektieren Sie es
Tokens pro Aufruf
Für Metadaten klein, können die Dateien sehr groß sein (Zehntausende von Tokens).
Kosten in €
Kostenlos – EDGAR ist öffentlich
Tipp
Verwenden Sie extract_section, anstatt die gesamte Datei zu sichern. Die Abschnitte MD&A oder Risikofaktoren allein reichen normalerweise aus.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: SEC_EDGAR_USER_AGENT identifiziert Sie gegenüber SEC; Verwenden Sie einen echten Namen und eine erreichbare E-Mail-Adresse. Überweisen Sie Ihre persönliche E-Mail-Adresse nicht an eine gemeinsam genutzte Konfiguration.
Datenabfluss: Alle Anrufe gehen an sec.gov. In der Standardkonfiguration sind keine Dienste von Drittanbietern enthalten.

Fehlerbehebung

Häufige Fehler und Lösungen

403 von Sec.gov

Ihr User-Agent fehlt oder ist fehlerhaft. SEC erfordert das Format „Name ([email protected])“.

Prüfen: echo $SEC_EDGAR_USER_AGENT
Begrenzter Preis (429)

Reduzieren Sie den Wert auf unter 10 Anforderungen/s. Stapeln per CIK, anstatt viele parallele Aufrufe auszugeben.

Prüfen: Inspect headers on the failing response
XBRL-Konzept nicht gefunden

Das Unternehmen darf dieses Konzept nicht melden. Verwenden Sie get_company_facts, um zu sehen, welche Konzepte existieren.

Prüfen: get_company_facts(cik) and grep for the concept

Alternativen

SEC EDGAR MCP vs. andere

AlternativeWann stattdessenKompromiss
yahoo-financeSie möchten Kurse + grundlegende Grundlagen ohne Präzision auf SEC-EbeneWeniger maßgeblich; keine direkten Einreichungen
alpacaSie benötigen Broker-Marktdaten und HandelKeine Einreichungen; unterschiedliche Datenform

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen