finans-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| araci_kurum_listesiA | Sistemde kayıtlı tüm aracı kurumları ve araştırma portalı kaynaklarını listele. Borsa İstanbul üye kodları, araştırma portalları (Portal 1 & Portal 2), hedef fiyat takip URL'leri ve Python kütüphane ipuçlarını döndürür. |
| rapor_indirA | Aracı kurumdan güncel rapor indir ve tarih bazlı klasöre kaydet. Dosyalar data/raporlar/{yıl}/{ay}/{gün}/{tarih}-{kurum}-{tip}.pdf yapısında saklanır. |
| konsensus_analizA | Tüm aracı kurumların hedef fiyatlarını çapraz karşılaştır ve konsensüs skoru üret. İndirilen raporlardaki hedef fiyatları sentezleyerek:
|
| korelasyon_raporuA | Aracı kurumlar arasındaki hedef fiyat korelasyonunu hesapla. Hangi kurumlar birbirine yakın tahminler yapıyor? Hangi kurum sürüden ayrışıyor? Pearson korelasyon katsayısı ve ortalama sapma yüzdesi ile raporlar. |
| sapma_analizi_raporuA | Konsensüsten en çok sapan analist görüşlerini bul. Z-skoru ile ölçerek hangi aracı kurum hangi hissede sürüden ayrışıyor belirler. Kontrarian fırsat tespiti için kullanılır. |
| veri_durumuA | İndirilen raporların ve veri dizininin genel durumunu göster. Hangi tarihlerde kaç rapor indirilmiş, dizin yapısının özeti. |
| openbb_hisse_analizB | OpenBB ve yfinance entegrasyonu ile BIST ve küresel hisse temel analiz verilerini çek. Fiyat/Kazanç (F/K), Piyasa Değeri / Defter Değeri (PD/DD), Temettü Verimi, 52 Haftalık aralık ve analist ortalama hedef fiyatlarını raporlar. |
| openbb_makro_gostergelerA | OpenBB entegrasyonu ile USD/TRY, EUR/TRY, BIST100, Altın, Petrol ve S&P500 makro verilerini getir. |
| monte_carlo_simulasyonuA | Geometric Brownian Motion (GBM) ile Monte Carlo Fiyat Yolu Simülasyonu gerçekleştir. Boyle (1977) ve Glasserman (2003) tarafından teorik ve pratikte kanıtlanmış GBM modelini kullanır. 2,500 rastgele fiyat patikası simüle ederek Ayı (%5 P5), Medyan (%50 P50) ve Boğa (%95 P95) senaryoları ile VaR (Value at Risk) ve CVaR risk metriklerini hesaplar. |
| markowitz_portfoy_optimizasyonuA | Markowitz Modern Portföy Teorisi (1952) ile Etkin Sınır ve Maksimum Sharpe Portföyü hesapla. Nobel Ödüllü Harry Markowitz (1952) yöntemini kullanarak 10,000 rastgele portföy simüle eder, Sharpe oranını maksimize eden optimal varlık dağılım ağırlıklarını çıkarır. |
| kap_son_bildirimlerA | Kamuyu Aydınlatma Platformu (KAP) üzerinden şirket açıklamalarını ve bildirimlerini çek. Özel Durum Açıklamaları (ÖDA), Finansal Raporlar, Temettü ve Sermaye Artırımı bildirimlerini orijinal KAP URL'leri ile getirir. |
| kap_insider_islemleriA | KAP üzerinden yönetim kurulu üyeleri ve büyük ortakların pay alım/satım (Insider) bildirimlerini listele. |
| spk_yasal_uyum_denetimiA | Sistemin 6362 sayılı Sermaye Piyasası Kanunu ve SPK Tebliğlerine uyum durumunu denetle. Yatırım Danışmanlığı lisans şartları (Tebliğ III-52.1), Bilgi Suistimali (Madde 106) ve Piyasa Dolandırıcılığı (Madde 107) açısından yasal koruma maddelerini raporlar. |
| portfoy_risk_analiziA | Portföyün Sharpe, Sortino, Max Drawdown risk metriklerini ve HHI yoğunlaşma skorunu hesapla. |
| stres_testi_simulasyonuB | Portföyü BIST Çöküşü, Kur Şoku, Faiz Artışı ve Stagflasyon kriz senaryolarında simüle et. |
| tcmb_evds_gostergelerA | TCMB EVDS ve TÜİK verileri ile Politika Faizi, TÜFE/ÜFE, Rezervler ve Kur göstergelerini raporla. |
| tefas_fon_analizB | TEFAS (Türkiye Elektronik Fon Alım Satım Platformu) fon fiyatı, AUM büyüklüğü ve getiri analizi yap. |
| karar_denetim_defteriB | Geçmiş yatırım kararlarını Verdict Matrisi (Doğru/Yanlış Gerekçe x Sonuc) ile denetle ve kalibrasyon skoru üret. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 18 tools
Most tools have distinct targets, but several quantitative/analytical tools overlap: portfoy_risk_analizi, monte_carlo_simulasyonu, and stres_testi_simulasyonu all compute risk metrics (VaR, CVaR) and could be confused. Similarly, sapma_analizi_raporu and korelasyon_raporu both measure analyst divergence. The descriptions help, but the boundaries are slightly blurry.
Tool names are mostly snake_case noun phrases (e.g., kap_son_bildirimler, portfoy_risk_analizi), but rapor_indir follows an object-verb pattern. Prefixes like kap_, spk_, tcmb_, tefas_, openbb_ are applied inconsistently, and no uniform verb_noun or noun_verb structure is maintained across the set.
At 18 tools, the server is on the heavier side but still appropriate for a comprehensive finance domain covering regulatory data, analytics, simulations, and report management. Each tool fills a niche, though a few could potentially be consolidated.
The server covers a broad swath of Turkish financial research: KAP disclosures, insider transactions, regulatory compliance, portfolio analytics, macro data, fund analysis, broker consensus, and simulations. Minor gaps exist (e.g., no dedicated tool for financial statement parsing beyond KAP announcements), but the overall surface is robust and cohesive.