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/mcpKlien 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
| Fail | Apa itu |
|---|---|
| openapi.json | OpenAPI 3.1. Setiap operasi mempunyai penerangan dan permintaan contoh dengan ticker sebenar |
| llms.txt | Panduan ringkas: hos, id syarikat, objek nilai, bacaan pada titik masa tertentu (point-in-time), had |
| llms-full.txt | Segalanya dalam satu fail teks: setiap laluan, formula nisbah dan resipi |
| skill.md | Kemahiran Ejen dengan resipi satu panggilan |
| skills.zip | Kemahiran Ejen (SKILL.md) yang memanggil alat MCP, dalam satu fail zip |
| pricing.json | Harga setiap panggilan, had harian dan status pembayaran |
| mcp.json | Kad pelayan MCP: alat, pengesahan dan dokumen |
| server.json | Entri Registry MCP |
| agent.json | Satu 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.fromdanknown.tomenyatakan bila setiap nilai adalah angka terkini yang difailkan.as_of,original=truedanhistory=truemembaca 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, atauGET /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.