FinancialMD für KI-Agenten

FinancialMD ist ein KI-natives Finanzterminal für Agenten. Es liefert Finanzabschlüsse, die aus Einreichungen bei der SEC (eingereichten Dokumenten) erstellt werden. Jede Zahl enthält einen Nachweis, der zur Einreichung bei der SEC (eingereichtes Dokument) zurückführt, und jeder Abruf kann mit dem Stand eines vergangenen Datums erfolgen. So kann ein Agent seine Aussagen belegen und Backtests ohne Rückgriff auf später verfügbare Informationen durchführen.

Schritt 1. Den MCP-Server verbinden

Der MCP-Server ist unter https://mcp.financial.md/mcp erreichbar (Streamable HTTP, zustandslos). Er bietet 50 schreibgeschützte Tools. Die Anmeldung ist optional: Ohne Token antwortet er innerhalb der täglichen Limits für Zugriffe ohne Schlüssel.

Claude Code:

claude mcp add --transport http financial-md https://mcp.financial.md/mcp

Clients, die eine JSON-Konfiguration einlesen (Cursor, VS Code, Windsurf und andere):

{
  "mcpServers": {
    "financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
  }
}

Fügen Sie in Claude oder ChatGPT dieselbe URL als benutzerdefinierten Konnektor hinzu. Die Serverkarte finden Sie unter mcp.financial.md/.well-known/mcp.json und die OAuth-Metadaten unter mcp.financial.md/.well-known/oauth-protected-resource.

Beginnen Sie mit company_lookup, dann mit snapshot_as_of (alle drei Abschlussrechnungen und die Kennzahlen mit dem an einem bestimmten Datum bekannten Stand in einem einzigen Aufruf) oder financials_standardized. Verwenden Sie verify_value, um eine Zahl zu prüfen, die Sie anderswo gefunden haben.

Schritt 2. Einen API-Aufruf ohne Schlüssel ausführen

Die HTTP API benötigt weder ein Konto noch einen Schlüssel. Dieser Aufruf liefert die letzten fünf jährlichen Kapitalflussrechnungen von Apple, einschließlich Free Cashflow:

curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"

Jede Zahl ist ein Wertobjekt mit proof.accession, proof.form, proof.filed und proof.source_url (die Einreichung bei der SEC (eingereichtes Dokument) auf sec.gov). Fügen Sie as_of=2024-06-30 hinzu, um den an diesem Datum bekannten Stand abzurufen. Prüfen Sie eine Zahl anhand der Einreichung bei der SEC (eingereichtes Dokument):

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
  -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

Ohne Schlüssel stehen jeder IP-Adresse täglich 25 kontingentierte Aufrufe (Kennzahlen, Screening, Verifizierung), 1,000 Lesezugriffe auf die Ebene der Einreichungen bei der SEC (eingereichten Dokumente) und 1,000 Metadaten-Lesezugriffe zur Verfügung. Jede Antwort enthält RateLimit-*-Header; eine 429-Antwort enthält Retry-After, und jeder Fehlerantwort-Body listet Abhilfemaßnahmen auf.

Schritt 3. Pro Aufruf bezahlen

agent.financial.md stellt dieselben Routen für Agenten bereit, die pro Aufruf mit x402 (USDC auf Base) bezahlen, ohne ein Konto zu benötigen. Eine kostenpflichtige Route antwortet dort mit 402 und dem Preis in einem PAYMENT-REQUIRED-Header; signieren Sie die Zahlung und senden Sie den Aufruf erneut mit einem PAYMENT-SIGNATURE-Header. Der Body der 402-Antwort nennt auch den Host für Zugriffe ohne Schlüssel, auf dem dieselbe Route innerhalb der täglichen Limits kostenlos ist.

Der Preis jeder Route steht in pricing.json und im Feld x-price des OpenAPI-Dokuments. Maßgeblich ist der Preis in der 402-Antwort. Ein fehlgeschlagener Aufruf wird nicht berechnet.

Dateien für Agenten

Datei	Beschreibung
openapi.json	OpenAPI 3.1. Jede Operation hat eine Beschreibung und eine Beispielanfrage mit einem echten Tickersymbol
llms.txt	Kurzanleitung: Hosts, Unternehmens-IDs, das Wertobjekt, stichtagsbezogene (point-in-time) Lesezugriffe, Limits
llms-full.txt	Alles in einer Textdatei: jede Route, Kennzahlenformel und Anleitung
skill.md	Ein Agent Skill mit Anleitungen für einen einzigen Aufruf
skills.zip	Agent Skills (SKILL.md), die die MCP-Tools aufrufen, in einer einzigen ZIP-Datei
pricing.json	Preise pro Aufruf, kostenlose Kontingente und Zahlungsstatus
mcp.json	MCP-Serverkarte: Tools, Authentifizierung und Dokumente
server.json	Der Eintrag in der MCP Registry
agent.json	Ein gemeinsames Verzeichnis aller oben genannten Endpunkte und Dokumente

Worauf sich ein Agent verlassen kann

Jede Zahl hat eine Quelle: die Zugangsnummer, das Formular und das Einreichungsdatum der Einreichung bei der SEC (eingereichtes Dokument), den XBRL-Tag und einen Link zum Dokument auf sec.gov. GET /proof/{id} zeigt die zugrunde liegenden Rohdaten.
Stichtagsbezogen (point-in-time): known.from und known.to geben an, wann jeder Wert die zuletzt eingereichte Zahl war. as_of, original=true und history=true lesen vergangene Daten ohne Vorgriff auf spätere Informationen und zeigen nachträgliche Anpassungen.
Kurze Antworten: Ein Abschlussabruf liefert nur die angefragten Perioden; Ergebnisse von MCP-Tools beginnen mit einer einzeiligen Zusammenfassung vor den strukturierten Daten.
Ticker, CIK oder Name: company=ticker:AAPL, company=cik:320193 oder GET /v1/companies?q=Apple.
Abdeckung: Unternehmen, die bei der SEC einreichen und derzeit an einer US-Börse notiert sind; standardisierte Abschlüsse für Unternehmen, die nach US GAAP berichten. Nur zur Information, keine Anlageberatung.