Hoppa till innehållet

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/mcp

Klienter 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

FilVad det är
openapi.jsonOpenAPI 3.1. Varje operation har en beskrivning och en exempelförfrågan med en verklig ticker
llms.txtKort guide: värdar, företags-id:n, värdeobjektet, läsningar vid en given tidpunkt (point-in-time), gränser
llms-full.txtAllt i en textfil: varje rutt, kvotformel och recept
skill.mdEn Agent Skill med recept för ett anrop
skills.zipAgent Skills (SKILL.md) som anropar MCP-verktygen, i en zip-fil
pricing.jsonPriser per anrop, dagliga gränser och betalningsstatus
mcp.jsonMCP-serverkort: verktyg, autentisering och dokument
server.jsonPosten i MCP Registry
agent.jsonEtt 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.from och known.to anger när varje värde var den senast inlämnade siffran. as_of, original=true och history=true lä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, eller GET /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.