Ajanlar için FinancialMD
FinancialMD, ajanlar için AI-native bir finans terminalidir. SEC bildirimlerinden oluşturulmuş finansal tablolar sunar. Her sayı, bildirime kadar giden bir kanıt taşır ve her okuma geçmiş bir tarih itibarıyla yapılabilir; böylece bir ajan söylediklerine kaynak gösterebilir ve ileriye bakma yanlılığı olmadan geriye dönük test yapabilir.
Adım 1. MCP sunucusunu bağla
MCP sunucusu https://mcp.financial.md/mcp adresindedir (Streamable HTTP, stateless). 57 salt okunur aracı vardır. Oturum açmak isteğe bağlıdır: token olmadan, anahtarsız günlük sınırlar içinde yanıt verir.
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpJSON yapılandırmasını okuyan istemciler (Cursor, VS Code, Windsurf ve diğerleri):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Claude veya ChatGPT'de aynı URL'yi özel bir bağlayıcı olarak ekleyin. Sunucu kartı mcp.financial.md/.well-known/mcp.json adresindedir; OAuth metadata ise mcp.financial.md/.well-known/oauth-protected-resource adresindedir.
company_lookup ile başlayın, ardından snapshot_as_of (tek çağrıda üç tablo ile bir tarihte bilinen oranların tamamı) veya financials_standardized kullanın. Başka bir yerde bulduğunuz bir sayıyı kontrol etmek için verify_value kullanın.
Adım 2. Anahtarsız bir API çağrısı yapın
HTTP API hesap da anahtar da gerektirmez. Bu çağrı, Apple'ın son beş yıllık nakit akış tablolarını serbest nakit akışıyla birlikte döndürür:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"Her sayı, proof.accession, proof.form, proof.filed ve proof.source_url (sec.gov'daki bildirim) içeren bir değer nesnesidir. O tarihte bilinenleri okumak için as_of=2024-06-30 ekleyin. Bir sayıyı bildirim ile karşılaştırın:
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}'Anahtar olmadan, her IP adresi günde 10 ölçümlü çağrı (oranlar, tarama, doğrulama), 1,000 bildirim katmanı okuması ve 1,000 üstveri okuması alır. Her yanıt RateLimit-* başlıklarını taşır; 429 yanıtı Retry-After taşır ve her hata gövdesi çözüm yollarını listeler.
Adım 3. Çağrı başına ödeme
agent.financial.md, hesap olmadan x402 (USDC on Base) ile çağrı başına ödeme yapan ajanlar için aynı yolları sunar. Oradaki ücretli bir yol, 402'yi PAYMENT-REQUIRED başlığında fiyatla yanıtlar; ödemeyi imzalayın ve çağrıyı PAYMENT-SIGNATURE başlığıyla yeniden gönderin. 402'nin gövdesi ayrıca anahtarsız ana makineyi de belirtir; aynı yol burada günlük sınırlar içinde hiçbir zaman ücret alınmaz.
Her yolun fiyatı pricing.json içinde ve OpenAPI belgesindeki x-price alanındadır. Uygulanan fiyat, 402 yanıtındaki fiyattır. Başarısız olan bir çağrı ücretlendirilmez.
Ajanlar için dosyalar
| Dosya | Nedir |
|---|---|
| openapi.json | OpenAPI 3.1. Her işlemin bir tanımı ve gerçek bir ticker'la örnek bir isteği vardır |
| llms.txt | Kısa kılavuz: ana makineler, şirket kimlikleri, değer nesnesi, belirli bir tarih itibarıyla (point-in-time) okumalar, limitler |
| llms-full.txt | Her şey tek bir metin dosyasında: her yol, oran formülü ve tarif |
| skill.md | Tek çağrılık tarifler içeren bir Agent Skill |
| skills.zip | MCP araçlarını çağıran Agent Skills (SKILL.md), tek bir zip olarak |
| pricing.json | Çağrı başına fiyatlar, günlük limitler ve ödeme durumu |
| mcp.json | MCP sunucu kartı: araçlar, kimlik doğrulama ve belgeler |
| server.json | MCP Registry girdisi |
| agent.json | Yukarıdaki her uç nokta ve belgenin bir indeksi |
Bir ajanın güvenebileceği şeyler
- Her sayının bir kaynağı vardır: bildirimin accession number'ı, formu, bildirim tarihi, XBRL etiketi ve sec.gov üzerindeki belgeye bir bağlantı.
GET /proof/{id}bunun arkasındaki ham verileri gösterir. - Belirli bir tarih itibarıyla (point-in-time):
known.fromveknown.to, her değerin en son bildirilen rakam olduğu dönemi gösterir.as_of,original=truevehistory=true, ileriye bakmadan geçmişi okur ve yeniden düzenlemeleri gösterir. - Kısa yanıtlar: bir tablo çağrısı yalnızca istenen dönemleri döndürür; MCP araç sonuçları, yapılandırılmış veriden önce tek satırlık bir özetle başlar.
- Ticker, CIK veya isim:
company=ticker:AAPL,company=cik:320193, veyaGET /v1/companies?q=Apple. - Kapsam: bugün bir US borsasında işlem gören SEC bildirim yapan şirketler; US GAAP bildirim yapanlar için standartlaştırılmış tablolar. Yalnızca bilgilendirme amaçlıdır, yatırım tavsiyesi değildir.