edgar-mcp

Ein MCP-Server, der Claude die Volltextsuche in SEC-Einreichungen ermöglicht.

Fragen Sie Claude „Welche Unternehmen haben dieses Jahr in ihren 10-Ks agentic AI thematisiert?“ und er durchsucht direkt EDGAR — 235 echte Einreichungen, mit Links.

https://github.com/user-attachments/assets/afa2e1e5-ee79-42ad-a736-6f016b8f6c64

Das schwierigste Problem

EDGAR filtert nach CIK, einer zehnstelligen Kennung, die für einen Menschen nichts bedeutet und für die API alles. Das naheliegende Design nimmt eine CIK als Tool-Parameter und überlässt es dem Modell, sie zu liefern. Das scheitert auf die denkbar schlechteste Weise: Ein Sprachmodell wird für jedes Unternehmen, das es nicht auswendig kennt, selbstbewusst eine CIK erfinden, und die Einreichungen eines falschen Unternehmens sehen genauso aus wie die des richtigen — korrekt formatiert, plausibel und völlig falsch, ohne dass etwas auf den Fehler hindeutet. Deshalb akzeptieren die Tools einen Ticker oder Firmennamen und lösen ihn im Code anhand der eigenen Zuordnungsdatei der SEC auf. Ist der Name mehrdeutig — „American“ passt auf 66 Unternehmen —, gibt der Resolver die Kandidatenliste zurück, statt die am höchsten bewertete Übereinstimmung zu wählen, und Claude fragt, welche gemeint ist. Das Modell erledigt die einfachen Fälle über den Kontext; der Code fängt diejenigen ab, die es falsch macht.

Related MCP server: EdgarTools MCP

Installation

npm install -g @alinarashid/edgar-mcp

Fügen Sie in claude_desktop_config.json ein:

{
  "mcpServers": {
    "edgar": {
      "command": "npx",
      "args": ["-y", "@alinarashid/edgar-mcp"],
      "env": {
        "SEC_USER_AGENT": "your-app your@email.com"
      }
    }
  }
}

SEC_USER_AGENT ist erforderlich. Die SEC lehnt Anfragen ab, die den Aufrufer nicht identifizieren, und ein fehlender Header liefert 403 statt eines leeren Ergebnisses.

Starten Sie Claude Desktop neu.

Tools

search_filings — Volltextsuche über alle Einreichungen seit 2001. Filtern Sie nach Formulartyp, Datumsbereich und Unternehmen. Gibt das einreichende Unternehmen, das Formular, das Datum und einen Dokumentlink zurück.

list_company_filings — die Einreichungen eines Unternehmens, neueste zuerst. Akzeptiert einen Ticker oder Namen. Filtern Sie nach Formulartyp, sonst erhalten Sie überwiegend Form-4-Insider-Geschäfte.

Beispiele

Welche Unternehmen haben „agentic AI“ in ihren 10-K-Einreichungen dieses Jahres erwähnt?

Zeigen Sie mir die jüngsten Quartalsberichte von American Airlines.

Finden Sie 8-K-Einreichungen aus 2026, die „material weakness“ erwähnen.

Bekannte Grenzen

• Die Suche liefert Metadaten, keinen Text. Sie sagt Ihnen, welche Einreichungen passen, nicht, was sie aussagen. Folgen Sie der URL, um den Wortlaut zu lesen.

• Das Ranking folgt der Keyword-Relevanz, nicht der Unternehmensgröße. Eine kurze Einreichung, die eine Phrase wiederholt, schlägt eine 300-seitige 10-K, die sie zweimal erwähnt.

• Nur börsennotierte Unternehmen. Privatunternehmen reichen nichts bei der SEC ein.

• Die Suche innerhalb eines Unternehmens umfasst auch Dritteinreichungen, die mit dieser CIK gekennzeichnet sind, etwa Aktionärsanträge externer Gruppen.

Hinweise

Der Volltext-Endpunkt unter efts.sec.gov ist undokumentiert — die SEC veröffentlicht keine Parameterliste, kein Antwortschema und keine Stabilitätsgarantie. Dieses Paket liest defensiv und muss möglicherweise aktualisiert werden, wenn sich die Struktur ändert.

Anfragen werden auf etwa 8 pro Sekunde serialisiert, unter der von der SEC veröffentlichten Obergrenze von 10.

Lizenz

MIT