Ga naar inhoud

FinancialMD voor AI-agenten

FinancialMD is een AI-native financiële terminal voor agenten. Het levert financiële overzichten op basis van indieningen bij de SEC (ingediende documenten). Elk getal heeft bewijs terug naar de indiening bij de SEC (ingediend document), en elke read kan op een historische datum worden gedaan, zodat een agent kan verwijzen naar wat het zegt en backtesten zonder look-ahead.

Stap 1. Verbind de MCP-server

De MCP-server bevindt zich op https://mcp.financial.md/mcp (Streamable HTTP, stateless). Hij heeft 57 alleen-lezen tools. Inloggen is optioneel: zonder token antwoordt hij binnen de dagelijkse limieten zonder sleutel.

Claude Code:

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

Clients die een JSON-configuratie lezen (Cursor, VS Code, Windsurf en anderen):

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

Voeg in Claude of ChatGPT dezelfde URL toe als een aangepaste connector. De serverkaart staat op mcp.financial.md/.well-known/mcp.json en OAuth-metadata op mcp.financial.md/.well-known/oauth-protected-resource.

Begin met company_lookup, dan snapshot_as_of (alle drie de overzichten en de ratio's zoals bekend op een datum, in één oproep) of financials_standardized. Gebruik verify_value om een getal te controleren dat je elders hebt gevonden.

Stap 2. Doe een API-call zonder sleutel

De HTTP API heeft geen account en geen sleutel nodig. Deze call levert Apple's laatste vijf jaarlijkse kasstroomoverzichten op, inclusief vrije kasstroom:

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

Elk getal is een waardeobject met proof.accession, proof.form, proof.filed en proof.source_url (de indiening bij de SEC (ingediend document) op sec.gov). Voeg as_of=2024-06-30 toe om te lezen wat op die datum bekend was. Controleer een getal aan de hand van de indiening bij de SEC (ingediend document):

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}'

Zonder sleutel krijgt elk IP-adres 10 gemeten verzoeken per dag (ratios, screen, verify), 1,000 reads op het niveau van indieningen bij de SEC (ingediende documenten) en 1,000 metadata-reads. Elke response bevat RateLimit-*-headers; een 429 bevat Retry-After, en elke error body vermeldt oplossingen.

Stap 3. Betaal per call

agent.financial.md bedient dezelfde routes voor agenten die per call betalen met x402 (USDC op Base), zonder account. Een geprijsde route daar antwoordt met 402 en de prijs in een PAYMENT-REQUIRED header; onderteken de betaling en stuur de call opnieuw met een PAYMENT-SIGNATURE header. De body van de 402 noemt ook de keyless host, waar dezelfde route binnen de dagelijkse limieten nooit in rekening wordt gebracht.

De prijs van elke route staat in pricing.json en in het x-price-veld van het OpenAPI document. De prijs in het 402-antwoord is de prijs die geldt. Een call die mislukt, wordt niet in rekening gebracht.

Bestanden voor agenten

BestandWat het is
openapi.jsonOpenAPI 3.1. Elke bewerking heeft een beschrijving en een voorbeeldrequest met een echte ticker
llms.txtKorte gids: hosts, bedrijfs-id's, het waardeobject, op peildatum (point-in-time)-reads, limieten
llms-full.txtAlles in één tekstbestand: elke route, ratioformule en recept
skill.mdEen Agent Skill met recepten voor één call
skills.zipAgent Skills (SKILL.md) die de MCP tools als één zip aanroepen
pricing.jsonPrijzen per call, dagelijkse limieten en betaalstatus
mcp.jsonMCP-serverkaart: tools, authenticatie en documenten
server.jsonDe MCP Registry-vermelding
agent.jsonEén index van elk endpoint en document hierboven

Waar een agent op kan vertrouwen

  • Elk getal heeft een bron: het accession number, formulier, indieningsdatum en XBRL-tag van de indiening bij de SEC (ingediend document), plus een link naar het document op sec.gov. GET /proof/{id} toont de ruwe feiten erachter.
  • Op peildatum (point-in-time): known.from en known.to geven aan wanneer elke waarde het laatst ingediende cijfer was. as_of, original=true en history=true lezen het verleden zonder vooruit te kijken en tonen herzieningen.
  • Korte antwoorden: een statement-call geeft alleen de gevraagde perioden terug; MCP-toolresultaten beginnen met een samenvatting van één regel vóór de gestructureerde data.
  • Ticker, CIK of naam: company=ticker:AAPL, company=cik:320193, of GET /v1/companies?q=Apple.
  • Dekking: SEC-indieners die vandaag op een Amerikaanse beurs zijn genoteerd; gestandaardiseerde overzichten voor US GAAP-indieners. Alleen informatie, geen beleggingsadvies.