Langkau ke kandungan

FinancialMD untuk ejen AI

FinancialMD ialah terminal kewangan natif AI untuk ejen. Ia menyediakan penyata kewangan yang dibina daripada pemfailan SEC. Setiap nombor membawa bukti kepada pemfailan SEC, dan setiap bacaan boleh dibuat setakat tarikh lampau, supaya ejen boleh memetik apa yang dikatakannya dan menjalankan ujian belakang tanpa look-ahead.

Langkah 1. Sambungkan pelayan MCP

Pelayan MCP berada di https://mcp.financial.md/mcp (Streamable HTTP, stateless). Ia mempunyai 57 alat baca sahaja. Log masuk adalah pilihan: tanpa token ia menjawab dalam had harian tanpa kunci.

Claude Code:

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

Klien yang membaca konfigurasi JSON (Cursor, VS Code, Windsurf dan lain-lain):

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

Dalam Claude atau ChatGPT, tambah URL yang sama sebagai penyambung tersuai. Kad pelayan berada di mcp.financial.md/.well-known/mcp.json dan metadata OAuth di mcp.financial.md/.well-known/oauth-protected-resource.

Mulakan dengan company_lookup, kemudian snapshot_as_of (ketiga-tiga penyata dan nisbah yang diketahui pada satu tarikh, dalam satu panggilan) atau financials_standardized. Gunakan verify_value untuk menyemak nombor yang anda jumpa di tempat lain.

Langkah 2. Buat panggilan API tanpa kunci

API HTTP tidak memerlukan akaun atau kunci. Panggilan ini mengembalikan lima penyata aliran tunai tahunan terakhir Apple, termasuk aliran tunai bebas:

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

Setiap nombor ialah objek nilai dengan proof.accession, proof.form, proof.filed dan proof.source_url (pemfailan di sec.gov). Tambah as_of=2024-06-30 untuk membaca apa yang diketahui pada tarikh itu. Semak nombor dengan pemfailan SEC:

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

Tanpa kunci, setiap alamat IP mendapat 10 panggilan bermeter sehari (nisbah, saringan, sahkan), 1,000 bacaan lapisan pemfailan SEC dan 1,000 bacaan metadata. Setiap respons membawa pengepala RateLimit-*; 429 membawa Retry-After, dan setiap badan ralat menyenaraikan langkah pemulihan.

Langkah 3. Bayar mengikut panggilan

agent.financial.md menyediakan laluan yang sama untuk ejen yang membayar bagi setiap panggilan dengan x402 (USDC on Base), tanpa akaun. Laluan berharga di sana menjawab dengan 402 berserta harga dalam pengepala PAYMENT-REQUIRED; tandatangani pembayaran dan hantar panggilan sekali lagi dengan pengepala PAYMENT-SIGNATURE. Badan 402 juga menyatakan hos tanpa kunci, di mana laluan yang sama tidak pernah dikenakan caj dalam had harian.

Harga setiap laluan ada dalam pricing.json dan dalam medan x-price pada dokumen OpenAPI. Harga dalam respons 402 ialah harga yang terpakai. Panggilan yang gagal tidak dikenakan caj.

Fail untuk ejen

FailApa itu
openapi.jsonOpenAPI 3.1. Setiap operasi mempunyai penerangan dan permintaan contoh dengan ticker sebenar
llms.txtPanduan ringkas: hos, id syarikat, objek nilai, bacaan pada titik masa tertentu (point-in-time), had
llms-full.txtSegalanya dalam satu fail teks: setiap laluan, formula nisbah dan resipi
skill.mdKemahiran Ejen dengan resipi satu panggilan
skills.zipKemahiran Ejen (SKILL.md) yang memanggil alat MCP, dalam satu fail zip
pricing.jsonHarga setiap panggilan, had harian dan status pembayaran
mcp.jsonKad pelayan MCP: alat, pengesahan dan dokumen
server.jsonEntri Registry MCP
agent.jsonSatu indeks bagi setiap titik akhir dan dokumen di atas

Apa yang boleh dipercayai oleh seorang ejen

  • Setiap nombor mempunyai sumber: nombor akses pemfailan SEC, borang, tarikh pemfailan, tag XBRL dan pautan ke dokumen di sec.gov. GET /proof/{id} menunjukkan fakta mentah di sebaliknya.
  • Titik masa: known.from dan known.to menyatakan bila setiap nilai adalah angka terkini yang difailkan. as_of, original=true dan history=true membaca masa lalu tanpa melihat ke hadapan dan menunjukkan penyataan semula.
  • Jawapan ringkas: panggilan penyata hanya mengembalikan tempoh yang diminta; hasil alat MCP bermula dengan ringkasan satu baris sebelum data berstruktur.
  • Ticker, CIK atau nama: company=ticker:AAPL, company=cik:320193, atau GET /v1/companies?q=Apple.
  • Liputan: pemfail SEC yang disenaraikan di bursa US hari ini; penyata piawai untuk pemfail US GAAP. Maklumat sahaja, bukan nasihat pelaburan.