FinancialMD för AI-agenter
FinancialMD är en AI-native finansiell terminal för agenter. Den levererar finansiella rapporter byggda från inlämningar till SEC. Varje siffra har ett bevis tillbaka till inlämningen till SEC, och varje läsning kan göras vid ett tidigare datum, så att en agent kan hänvisa till vad den säger och backtesta utan look-ahead.
Steg 1. Anslut MCP-servern
MCP-servern finns på https://mcp.financial.md/mcp (Streamable HTTP, stateless). Den har 57 skrivskyddade verktyg. Inloggning är valfri: utan token svarar den inom de dagliga gränserna utan nyckel.
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpKlienter som läser en JSON-konfiguration (Cursor, VS Code, Windsurf och andra):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}I Claude eller ChatGPT lägger du till samma URL som en anpassad anslutning. Serverkortet finns på mcp.financial.md/.well-known/mcp.json och OAuth-metadata på mcp.financial.md/.well-known/oauth-protected-resource.
Börja med company_lookup, sedan snapshot_as_of (alla tre finansiella rapporterna och nyckeltalen som de var kända vid ett datum, i ett anrop) eller financials_standardized. Använd verify_value för att kontrollera en siffra du hittade någon annanstans.
Steg 2. Gör ett API-anrop utan nyckel
HTTP API behöver inget konto och ingen nyckel. Detta anrop returnerar Apples fem senaste årliga kassaflödesanalyser, inklusive fritt kassaflöde:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Varje siffra är ett värdeobjekt med proof.accession, proof.form, proof.filed och proof.source_url (dokumentet på sec.gov). Lägg till as_of=2024-06-30 för att läsa vad som var känt på det datumet. Kontrollera en siffra mot dokumentet:
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}'Utan nyckel får varje IP-adress 10 uppmätta anrop per dag (nyckeltal, screen, verify), 1,000 läsningar på inlämningslagret och 1,000 metadata-läsningar. Varje svar innehåller RateLimit-*-headers; en 429 innehåller Retry-After, och varje feltext listar åtgärder.
Steg 3. Betala per anrop
agent.financial.md erbjuder samma rutter för agenter som betalar per anrop med x402 (USDC på Base), utan konto. En prissatt rutt där svarar med 402 och priset i en PAYMENT-REQUIRED-header; signera betalningen och skicka anropet igen med en PAYMENT-SIGNATURE-header. Själva 402-svaret nämner också den nyckellösa värden, där samma rutt aldrig debiteras inom de dagliga gränserna.
Priset för varje rutt finns i pricing.json och i fältet x-price i OpenAPI-dokumentet. Priset i 402-svaret är det som gäller. Ett anrop som misslyckas debiteras inte.
Filer för agenter
| Fil | Vad det är |
|---|---|
| openapi.json | OpenAPI 3.1. Varje operation har en beskrivning och en exempelförfrågan med en verklig ticker |
| llms.txt | Kort guide: värdar, företags-id:n, värdeobjektet, läsningar vid en given tidpunkt (point-in-time), gränser |
| llms-full.txt | Allt i en textfil: varje rutt, kvotformel och recept |
| skill.md | En Agent Skill med recept för ett anrop |
| skills.zip | Agent Skills (SKILL.md) som anropar MCP-verktygen, i en zip-fil |
| pricing.json | Priser per anrop, dagliga gränser och betalningsstatus |
| mcp.json | MCP-serverkort: verktyg, autentisering och dokument |
| server.json | Posten i MCP Registry |
| agent.json | Ett index över alla endpointar och dokument ovan |
Vad en agent kan lita på
- Varje siffra har en källa: dokumentets accession number, formulär, inlämningsdatum, XBRL-tagg och en länk till dokumentet på sec.gov.
GET /proof/{id}visar de råa fakta bakom den. - Vid en given tidpunkt (point-in-time):
known.fromochknown.toanger när varje värde var den senast inlämnade siffran.as_of,original=trueochhistory=trueläser det förflutna utan att titta framåt och visar omräkningar. - Korta svar: ett anrop för finansiella rapporter returnerar bara de perioder som efterfrågas; resultat från MCP-verktyg börjar med en sammanfattning på en rad före den strukturerade datan.
- Ticker, CIK eller namn:
company=ticker:AAPL,company=cik:320193, ellerGET /v1/companies?q=Apple. - Täckning: företag som lämnar in till SEC och är noterade på en US-börs idag; standardiserade rapporter för företag som rapporterar enligt US GAAP. Endast information, inte investeringsrådgivning.