İçeriğe geç

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

JSON 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

DosyaNedir
openapi.jsonOpenAPI 3.1. Her işlemin bir tanımı ve gerçek bir ticker'la örnek bir isteği vardır
llms.txtKısa kılavuz: ana makineler, şirket kimlikleri, değer nesnesi, belirli bir tarih itibarıyla (point-in-time) okumalar, limitler
llms-full.txtHer şey tek bir metin dosyasında: her yol, oran formülü ve tarif
skill.mdTek çağrılık tarifler içeren bir Agent Skill
skills.zipMCP 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.jsonMCP sunucu kartı: araçlar, kimlik doğrulama ve belgeler
server.jsonMCP Registry girdisi
agent.jsonYukarı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.from ve known.to, her değerin en son bildirilen rakam olduğu dönemi gösterir. as_of, original=true ve history=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, veya GET /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.