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/mcpClients 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
| Bestand | Wat het is |
|---|---|
| openapi.json | OpenAPI 3.1. Elke bewerking heeft een beschrijving en een voorbeeldrequest met een echte ticker |
| llms.txt | Korte gids: hosts, bedrijfs-id's, het waardeobject, op peildatum (point-in-time)-reads, limieten |
| llms-full.txt | Alles in één tekstbestand: elke route, ratioformule en recept |
| skill.md | Een Agent Skill met recepten voor één call |
| skills.zip | Agent Skills (SKILL.md) die de MCP tools als één zip aanroepen |
| pricing.json | Prijzen per call, dagelijkse limieten en betaalstatus |
| mcp.json | MCP-serverkaart: tools, authenticatie en documenten |
| server.json | De MCP Registry-vermelding |
| agent.json | Eé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.fromenknown.togeven aan wanneer elke waarde het laatst ingediende cijfer was.as_of,original=trueenhistory=truelezen 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, ofGET /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.