us-gov-data-mcp

Ein MCP-Server für US-Regierungsdaten. Fragen Sie Ihren KI-Assistenten, welche Bundesverträge auslaufen oder welche börsennotierten Unternehmen im letzten Jahr den höchsten Umsatz hatten – und erhalten Sie Antworten, die Sie anhand der offiziellen Aufzeichnungen der Regierung überprüfen können.

Basiert auf der USAspending-API des US-Finanzministeriums und den EDGAR-XBRL-Daten der SEC. Kein Scraping, kein API-Schlüssel, kein Konto, keine personenbezogenen Daten.

Warum es das gibt

Beide Quellen veröffentlichen alles und lassen Sie fast nichts davon abfragen.

usaspending.gov kann nicht nach Vertragsablaufdatum suchen. Wenn jedoch der Leistungszeitraum eines Bundesvertrags endet, muss die Arbeit in der Regel neu ausgeschrieben werden – und diese Neuausschreibungen sind die wahrscheinlichsten Gelegenheiten im öffentlichen Auftragswesen, die Monate vor jeder Ausschreibung in öffentlichen Daten sichtbar sind.

sec.gov stellt Einreichungen jeweils für ein Unternehmen bereit. Es gibt keine Möglichkeit auf der Website zu fragen, welche börsennotierten Unternehmen einen Umsatz von über 100 Milliarden Dollar hatten oder welche am meisten Bargeld halten. Die frames-API der SEC kann das in einem einzigen Aufruf für alle ~5.800 Einreicher beantworten – vorausgesetzt, man kennt bereits das XBRL-Tag und das Periodenformat.

Dieser Server beantwortet die Fragen, die diese Websites nicht beantworten können.

Related MCP server: sec-edgar-mcp

Vier Tools

find_expiring_contracts — Neuausschreibungen

Bundesverträge, die zur Neuvergabe anstehen, mit dem bisherigen Auftragnehmer und den verbleibenden Tagen. expiring_after_days legt Ihre Vorlaufzeit für Angebote fest, denn ein Vertrag, der nächste Woche ausläuft, ist nutzlos zur Vorbereitung.

{
  "days_until_expiry": 120,
  "recipient": "PERATON ENTERPRISE SOLUTIONS LLC",
  "amount_usd": 682369225.00,
  "awarding_agency": "General Services Administration",
  "verify_url": "https://www.usaspending.gov/award/..."
}

search_federal_contracts

Vergebene Verträge nach Behörde, Stichwort, Datum oder Betrag. Wer gewinnt Bundesaufträge, wofür eine Behörde ausgibt, die Historie eines Wettbewerbers.

screen_public_companies

Ordnen Sie jedes börsennotierte US-Unternehmen nach einer beliebigen gemeldeten Finanzkennzahl ein.

„Welche Unternehmen hatten 2023 einen Umsatz von über 200 Milliarden Dollar?"

{ "company": "Walmart Inc.", "value": 648125000000, "unit": "USD",
  "period_end": "2023-12-31", "period_type": "annual",
  "verify_url": "https://www.sec.gov/Archives/edgar/data/104169/..." }

company_financial_history

Die gemeldete Historie einer Kennzahl für ein Unternehmen – Umsatz, Nettogewinn, Vermögenswerte, Cashflow – dedupliziert, mit Formulartyp und Einreichungsdatum für jeden Datensatz.

Alles ist überprüfbar

Jeder Datensatz enthält eine verify_url zur behördlichen Einreichung, aus der er stammt. Öffnen Sie sie und vergleichen Sie.

Das ist besonders wichtig, wenn eine KI im Spiel ist: Wenn ein Assistent eine Dollarzahl meldet, sollten Sie sie gegen die Quelle prüfen können, statt der Kette zu vertrauen. Wenn ein Wert jemals von der offiziellen Aufzeichnung abweicht, ist das ein Fehler – bitte eröffnen Sie ein Issue.

Drei Fallstricke, die dieses Tool für Sie behandelt

Rohe SEC-Daten führen auf drei spezifische Arten in die Irre, jede davon still – Sie erhalten eine plausibel aussehende falsche Zahl, keinen Fehler.

1. Ein 10-Q meldet das Quartal und den Jahresverlauf mit demselben Enddatum. Der Vergleich des Nettogewinns über Einreichungen hinweg vermischt stillschweigend eine Drei-Monats-Zahl mit einer Neun-Monats-Zahl. Jeder Datensatz enthält period_type, und Sie können danach filtern.

2. Dieselbe Tatsache taucht in verschiedenen Einreichungen mit unterschiedlichen Werten auf. Der diesjährige 10-K stellt die Zahlen des Vorjahres neu dar. Dedupliziert auf einen Datensatz pro Periode, wobei die neueste Einreichung gewinnt – die eigene Behandlung von Neudarstellungen durch die SEC.

3. Unternehmen wechseln im Laufe der Zeit ihre XBRL-Tags. Microsoft meldete Revenues bis 2010 und danach ein anderes Tag. Wenn man das erste Tag nimmt, das Daten liefert, erhält man eine veraltete, unvollständige Historie; dieses Tool führt über alle hinweg zusammen.

Installation

uvx --from git+https://github.com/groundtruthtools/us-gov-data-mcp us-gov-data-mcp

Claude Desktop – fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "us-gov-data": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/groundtruthtools/us-gov-data-mcp",
        "us-gov-data-mcp"
      ],
      "env": { "SEC_USER_AGENT": "Your Name your@email.com" }
    }
  }
}

Funktioniert mit jedem MCP-Client: Claude Desktop, Claude Code, Cursor, VS Code.

SEC_USER_AGENT ist eine sinnvolle Einstellung. Die Fair-Access-Richtlinie der SEC verlangt einen User-Agent mit einer Kontaktadresse, und Anfragen ohne eine solche erhalten eine 403. Ein Standardwert ist enthalten, damit die Tools sofort funktionieren, aber sich zu identifizieren ist die höfliche Art und bewahrt Sie davor, unter einer gemeinsamen Identität zu laufen.

Eine Eigenheit, die wir auf die harte Tour gelernt haben: Setzen Sie keine URL in diese Zeichenkette. Die SEC gibt für jeden User-Agent mit einer URL eine 403 zurück. Ihr Name ihre@email.com funktioniert; das Hinzufügen von github.com/... nicht.

Noch nicht auf PyPI, daher Installation aus dem Repository. Wenn es dort ankommt, wird daraus ein einfaches uvx us-gov-data-mcp.

Ehrliche Grenzen

• Verträge: vergeben, nicht offene Ausschreibungen. Für veröffentlichte Angebote nutzen Sie SAM.gov.

• Verträge: nur Bundesebene, keine Daten vor dem Haushaltsjahr 2008.

• Die Neuausschreibungssuche umfasst Verträge mit Aktivität im letzten Jahr, weil USAspending begrenzt, wie tief Ergebnisse durchsucht werden können. Ein seit langem ruhender Vertrag erscheint möglicherweise nicht, und eine zu breite Suche sagt das, statt eine selbstbewusst leere Liste zurückzugeben.

• SEC: Die XBRL-Abdeckung beginnt etwa 2009 und umfasst nur Konzepte, die Unternehmen tatsächlich getaggt haben. Kleinere Einreicher taggen weniger.

• Es berichtet; es rechnet nicht. Keine Kennzahlen, Wachstumsraten oder abgeleitete Metriken – das wäre unsere Arithmetik statt der Einreichung, und Sie könnten sie nicht gegen die Quelle überprüfen.

• Keine Anlageberatung. Es ist ein Datenaufbereitungswerkzeug.

Auch auf Apify

Dieselbe Logik läuft als gehostete Tools, keine Installation erforderlich:

• US Federal Contract Awards & Recompete Finder

• SEC EDGAR Financial Data & Company Screener

Datenquellen und Lizenz

Verträge: USAspending.gov, US-Finanzministerium, veröffentlicht unter dem DATA Act. Finanzdaten: SEC EDGAR, US-Börsenaufsicht (SEC). Beide gemeinfrei. Code: MIT.