FinancialMD untuk agen AI

FinancialMD adalah terminal keuangan yang dirancang khusus untuk AI dan ditujukan bagi agen. Terminal ini menyediakan laporan keuangan yang disusun dari dokumen pelaporan SEC. Setiap angka dilengkapi bukti yang mengarah kembali ke dokumen pelaporan SEC, dan setiap pembacaan dapat dilakukan sesuai informasi yang tersedia pada tanggal lampau, sehingga agen dapat menyertakan sumber untuk pernyataannya dan melakukan uji historis tanpa menggunakan informasi masa depan.

Langkah 1. Hubungkan server MCP

Server MCP tersedia di https://mcp.financial.md/mcp (Streamable HTTP, tanpa status). Server ini memiliki 50 alat hanya-baca. Masuk bersifat opsional: tanpa token, server memberikan respons dalam batas 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 lainnya):

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

Di Claude atau ChatGPT, tambahkan URL yang sama sebagai konektor khusus. Kartu server tersedia di mcp.financial.md/.well-known/mcp.json dan metadata OAuth di mcp.financial.md/.well-known/oauth-protected-resource.

Mulai dengan company_lookup, lalu snapshot_as_of (ketiga laporan keuangan beserta rasio sesuai informasi yang diketahui pada suatu tanggal, dalam satu panggilan) atau financials_standardized. Gunakan verify_value untuk memeriksa angka yang Anda temukan di sumber lain.

Langkah 2. Lakukan panggilan API tanpa kunci

API HTTP tidak memerlukan akun maupun kunci. Panggilan ini mengembalikan lima laporan arus kas tahunan terakhir Apple, termasuk arus kas bebas:

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

Setiap angka merupakan objek nilai dengan proof.accession, proof.form, proof.filed, dan proof.source_url (dokumen pelaporan SEC di sec.gov). Tambahkan as_of=2024-06-30 untuk membaca informasi yang diketahui pada tanggal tersebut. Cocokkan angka dengan dokumen pelaporan 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 25 panggilan terukur per hari (ratios, screen, verify), 1,000 pembacaan lapisan dokumen pelaporan SEC, dan 1,000 pembacaan metadata. Setiap respons menyertakan header RateLimit-*; respons 429 menyertakan Retry-After, dan setiap isi respons kesalahan mencantumkan tindakan perbaikan.

Langkah 3. Bayar per panggilan

agent.financial.md menyediakan rute yang sama bagi agen yang membayar per panggilan dengan x402 (USDC di Base), tanpa akun. Rute berbayar di sana memberikan respons 402 dengan harga dalam header PAYMENT-REQUIRED; tanda tangani pembayaran dan kirim ulang panggilan dengan header PAYMENT-SIGNATURE. Isi respons 402 juga mencantumkan host tanpa kunci, tempat rute yang sama dapat digunakan gratis dalam batas harian.

Harga setiap rute tersedia di pricing.json dan dalam kolom x-price pada dokumen OpenAPI. Harga dalam respons 402 adalah harga yang berlaku. Panggilan yang gagal tidak dikenai biaya.

Berkas untuk agen

Berkas	Keterangan
openapi.json	OpenAPI 3.1. Setiap operasi memiliki deskripsi dan contoh permintaan dengan simbol saham nyata
llms.txt	Panduan singkat: host, ID perusahaan, objek nilai, pembacaan per tanggal tertentu (point-in-time), batas
llms-full.txt	Semuanya dalam satu berkas teks: setiap rute, rumus rasio, dan panduan praktis
skill.md	Sebuah Agent Skill dengan panduan praktis satu panggilan
skills.zip	Agent Skills (SKILL.md) yang memanggil alat MCP, dalam satu berkas zip
pricing.json	Harga per panggilan, batas penggunaan gratis, dan status pembayaran
mcp.json	Kartu server MCP: alat, autentikasi, dan dokumen
server.json	Entri MCP Registry
agent.json	Satu indeks untuk semua endpoint dan dokumen di atas

Apa yang dapat diandalkan oleh agen

Setiap angka memiliki sumber: nomor akses dokumen pelaporan SEC, formulir, tanggal dokumen pelaporan SEC, tag XBRL, dan tautan ke dokumen di sec.gov. GET /proof/{id} menampilkan fakta mentah yang mendasarinya.
Per tanggal tertentu (point-in-time): known.from dan known.to menunjukkan kapan setiap nilai merupakan angka terakhir yang dilaporkan. as_of, original=true, dan history=true membaca data masa lalu tanpa menggunakan informasi masa depan dan menampilkan penyajian kembali.
Jawaban singkat: panggilan laporan hanya mengembalikan periode yang diminta; hasil alat MCP dimulai dengan ringkasan satu baris sebelum data terstruktur.
Ticker, CIK, atau nama: company=ticker:AAPL, company=cik:320193, atau GET /v1/companies?q=Apple.
Cakupan: perusahaan pelapor SEC yang saat ini tercatat di bursa AS; laporan terstandardisasi untuk perusahaan pelapor US GAAP. Hanya informasi, bukan nasihat investasi.