finans-mcp
Finans MCP is an open-source, AI-powered enterprise financial intelligence server for Borsa Istanbul (BIST) and Turkish markets, providing 19 tools for institutional-grade analysis, simulation, and decision support.
Brokerage & Research
araci_kurum_listesi — List all 62 BIST brokerage firms with verified research portal URLs.
rapor_indir — Download and archive research reports by date, firm, and type.
veri_durumu — Check archive status and report summaries.
Consensus & Analyst Analysis
konsensus_analiz — Target price consensus (average, median, buy/hold/sell distribution), contrarian opinions.
korelasyon_raporu — Pearson correlation between broker estimates.
sapma_analizi_raporu — Detect outlier analyst views (Z-score > |1.5|).
Stock & Macro Data
openbb_hisse_analiz — Fundamental ratios (P/E, P/B, dividend yield, 52‑week range) for BIST and global stocks via OpenBB/yFinance.
openbb_makro_gostergeler — Real‑time macro data: USD/TRY, EUR/TRY, BIST100, gold, oil, S&P500.
Portfolio & Risk Modeling
monte_carlo_simulasyonu — 2,500‑path GBM simulation; bear/base/bull scenarios; VaR and CVaR.
markowitz_portfoy_optimizasyonu — 10,000‑portfolio Markowitz optimization; Sharpe‑maximizing weights.
portfoy_risk_analizi — Sharpe, Sortino, max drawdown, alpha, HHI concentration index.
stres_testi_simulasyonu — Stress tests under crises: BIST crash (‑30%), currency shock (+25%), rate hike, stagflation.
Public Disclosures & Compliance
kap_son_bildirimler — Latest KAP announcements (material disclosures, financials, dividends) with URLs.
kap_insider_islemleri — Insider transactions (board members, major shareholders).
spk_yasal_uyum_denetimi — Legal compliance audit against Capital Markets Law No. 6362 (information abuse, market manipulation).
Macroeconomic & Fund Data
tcmb_evds_gostergeler — TCMB policy rate, inflation (CPI/PPI), net reserves, exchange rates.
tefas_fon_analiz — TEFAS mutual funds: prices, AUM, investor count, returns.
bddk_bankacilik_verileri — BDDK banking sector ratios: balance sheet, loans/deposits, NPL, capital adequacy (CAR), ROE.
Decision Auditing
karar_denetim_defteri — Verdict Matrix (Right/Wrong Rationale × Outcome) and calibration score for investment decisions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@finans-mcp THYAO için aracı kurum hedef fiyat konsensüsünü getir"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 Finans MCP Server — BIST & Türkiye Piyasaları Yapay Zekâ Analiz Sunucusu
Finans MCP, Claude Desktop, Antigravity, Cursor, Windsurf, Roo Code ve tüm LLM/MCP istemcileri için geliştirilmiş, Borsa İstanbul (BIST), BDDK Bankacılık Sektör Verileri, TEFAS Yatırım Fonları, TCMB EVDS Makro Göstergeleri, KAP Bildirimleri, Aracı Kurum Konsensüs Tahminleri, Monte Carlo Simülasyonu ve Markowitz Portföy Optimizasyonu sunan açık kaynaklı kurumsal finans zekâ sunucusudur.
🌟 Neden Finans MCP?
📈 62 BIST Aracı Kurumunun Doğrulanmış Portal Bağlantıları: İş Yatırım, Garanti BBVA, Ak Yatırım, Yapı Kredi, Gedik, QNB Finans, Osmanlı Menkul, GCM, Ahlatcı ve daha fazlası.
🏛️ BDDK Türk Bankacılık Sektör Rasyoları (
bddkRUyumlu): Bilanço, Kredi/Mevduat, Takipteki Alacak (NPL), SYR ve ROE rasyoları.🎯 Analist Konsensüsü & Sapma (Contrarian) Analizi: Hedef fiyat ortalamaları, medyanlar, AL/TUT/SAT dağılımı ve konsensüsten ayrışan aykırı analist görüşleri (Z-skor > |1.5|).
🎲 Monte Carlo & Markowitz Portföy Optimizasyonu: Geometric Brownian Motion ile 2,500 patika simülasyonu, VaR/CVaR risk hesaplaması ve optimal Sharpe oranlı portföy ağırlıkları.
🏛️ TCMB EVDS Makro & TEFAS Fon Analizi: Politika faizi, TÜFE/ÜFE enflasyonu, TCMB net rezervleri, döviz kurları ve TEFAS fon fiyatları/AUM verileri.
🌩️ Makro Stres Testi & Karar Denetim Defteri (Verdict Matrisi): Portföyü BIST çöküşü (%-30), kur şoku (%+25) ve stagflasyonda simüle etme; geçmiş yatırım kararlarını Doğru/Yanlış Gerekçe × Sonuç matrisiyle denetleme.
⚖️ 6362 Sayılı SPK Kanunu Uyumlu: Bilgi Suistimali (Md. 106), Piyasa Dolandırıcılığı (Md. 107) ve Tebliğ III-52.1 uyarınca entegre yasal mevzuat koruması.
Related MCP server: Trading MCP Server
⚡ Hızlı Kurulum Rehberi (3 Seçenek)
Seçenek 1: Sadece Prompt ile Kurulum (Yapay Zekâya Verin - En Kolay)
Yapay zekânıza (Claude, Antigravity, Cursor, Roo Code) aşağıdaki komutu verin:
"https://github.com/tufankoc/finans-mcp reposunu incele ve
PROMPT_KURULUM.mddosyasındaki adımları izleyerek Finans MCP sunucusunu bilgisayarıma kur."
Seçenek 2: Tek Satır UVX / PIPX ile Çalıştırma (Sıfır Kurulum)
Sisteminize hiçbir şey kurmadan doğrudan çalıştırmak için MCP istemci konfigürasyonunuza (claude_desktop_config.json veya mcp_config.json) ekleyin:
{
"mcpServers": {
"finans-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/tufankoc/finans-mcp.git",
"finans-mcp"
]
}
}
}Seçenek 3: Terminalden 1-Komutla Kurulum (Yerel Kurulum)
git clone https://github.com/tufankoc/finans-mcp.git && cd finans-mcp && ./install.sh🎯 Maksimum Verim Almak İçin İstem Rehberi (Master Prompt)
Finans MCP sunucusunun 19 aracını tam verimle çalıştırmak için yapay zekanıza (Claude, Antigravity, Cursor) şu istemi yapıştırabilirsiniz:
"Sen Borsa İstanbul (BIST), BDDK Bankacılık Sektörü, TEFAS Fonları ve Türkiye Makroekonomisi alanında uzmanlaşmış Kıdemli Kurumsal Yatırım Danışmanısın. Benim sorularımda
openbb_hisse_analiz,konsensus_analiz,kap_son_bildirimler,monte_carlo_simulasyonu,markowitz_portfoy_optimizasyonu,stres_testi_simulasyonu,tcmb_evds_gostergeler,bddk_bankacilik_verileriaraçlarını zincirleme çalıştır; Temel, Teknik, ICT/SMC, Wyckoff ve Karar Matrisi boyutlarıyla raporla."
Detaylı sorular ve kullanım rehberi için PROMPT_KULLANIM.md rehberini inceleyin.
🛠️ Sunucu Araçları (MCP Tools - 19 Araç)
Tool | İşlev | Örnek Yapay Zekâ İsteği |
| Tüm 62 BIST üyesi aracı kurumun canlı doğrulanmış (200 OK) araştırma portal URL'lerini sunar. | "BIST aracı kurumlarının araştırma sitelerini listele." |
| Belirtilen tarih ve kurum için rapor verilerini çeker ve | "İş Yatırım'ın bugünkü raporlarını indir." |
| Hisseler için ortalama hedef fiyat, medyan, AL/TUT/SAT dağılımı ve konsensüs skoru hesaplar. | "THYAO için aracı kurumların hedef fiyat konsensüsünü getir." |
| Aracı kurumlar arasındaki tahmin korelasyonunu (Pearson $r$) karşılaştırır. | "Garanti ile Ak Yatırım arasındaki tahmin korelasyonunu çıkar." |
| Konsensüsten belirgin şekilde ayrışan (Z-skor > |1.5|) kontrarian analist görüşlerini saptar. | "Piyasadan ayrışan aykırı analist tahminlerini raporla." |
| Veri klasöründeki arşiv durumunu, toplam dosya ve tarih özetini raporlar. | "İndirilmiş rapor arşiv durumunu göster." |
| OpenBB & YFinance ile BIST ve küresel hisselerin temel rasyolarını (F/K, PD/DD, Temettü) getirir. | "GARAN ve EREGL temel rasyolarını karşılaştır." |
| OpenBB entegrasyonu ile Dolar/TL, Euro/TL, BIST100, Altın, Petrol ve S&P500 makro verilerini sunar. | "Güncel kur, enflasyon ve BIST100 makro tablosunu çıkar." |
| Geometric Brownian Motion (Boyle 1977) ile 2,500 patika simüle ederek Ayı/Boğa senaryolarını ve VaR/CVaR hesaplar. | "THYAO hissesi için 250 günlük Monte Carlo simülasyonu yap." |
| Markowitz Modern Portföy Teorisi (1952) ile 10,000 portföy simüle eder ve optimal Sharpe oranlı ağırlıkları bulur. | "THYAO, GARAN, KCHOL, TUPRS için optimal Markowitz portföyünü hesapla." |
| Kamuyu Aydınlatma Platformu (KAP) üzerinden şirket açıklamalarını (ÖDA, Bilanço, Temettü) orijinal URL'leri ile çeker. | "THYAO için son KAP açıklamalarını getir." |
| KAP pay alım/satım bildirimlerini (yönetim kurulu üyeleri ve büyük ortak işlemleri) süzerek raporlar. | "Son insider pay alım satımlarını raporla." |
| 6362 sayılı SPK Kanunu (Md. 106/107) ve Tebliğ III-52.1 uyarınca sistemin yasal koruma ve mevzuat denetimini sunar. | "SPK yasal uyum raporunu getir." |
| Portföyün Sharpe, Sortino, Max Drawdown, Alfa ve HHI Yoğunlaşma İndeksini hesaplar. | "Portföyümün Sharpe, Sortino ve HHI skorunu hesapla." |
| Portföyü BIST çöküşü, kur şoku, faiz artışı ve stagflasyon kriz senaryolarında simüle eder. | "Portföyü BIST çöküşü kriz senaryosunda simüle et." |
| TCMB EVDS ve TÜİK verileri ile Politika Faizi, TÜFE/ÜFE, Rezervler ve Kur göstergelerini sunar. | "TCMB politika faizi ve net rezerv verilerini getir." |
| TEFAS fon fiyatları, AUM (yönetilen varlık büyüklüğü), yatırımcı sayısı ve getirilerini raporlar. | "TI4 fonunun detaylarını ve yıllık getirisini göster." |
| Geçmiş yatırım kararlarını Verdict Matrisi (Doğru/Yanlış Gerekçe × Sonuç) ile denetler ve kalibrasyon skoru üretir. | "Geçmiş yatırım kararlarımın Verdict Matrisi analizini yap." |
| BDDK Türk Bankacılık Sektörü Bilanço, Krediler, Takipteki Alacak Oranı (NPL), SYR ve ROE verilerini sunar. | "BDDK mevduat ve kamu bankacılığı sektörü rasyolarını getir." |
🌐 MCP Registry & Ekosistem Kayıtları
Finans MCP aşağıdaki küresel MCP dizinlerinde yayınlanmıştır:
Smithery.ai:
smithery.jsonentegrasyonu ile tek tıkla yükleme.Glama.ai:
glama.jsonentegrasyonu ile listelenmiştir.
⚖️ Yasal Uyarı (SPK Disclaimer)
Yasal Uyarı: Bu sunucu ve araçlar tarafından sağlanan veri, analiz ve raporlar yatırım danışmanlığı kapsamında değildir. Yatırım danışmanlığı hizmeti; aracı kurumlar, portföy yönetim şirketleri, mevduat kabul etmeyen bankalar ile müşteri arasında imzalanacak yatırım danışmanlığı sözleşmesi çerçevesinde sunulmaktadır. Burada yer alan görüş ve analizler genel niteliktedir ve sadece bilgilendirme amacı taşımaktadır.
📜 Lisans
Bu proje MIT Lisansı ile lisanslanmıştır. Özgürce kullanılabilir, geliştirilebilir ve dağıtılabilir.
Available Tools
18 toolsaraci_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.
Inputs: no named parameters. Returns: result
kap_insider_islemleriA
KAP üzerinden yönetim kurulu üyeleri ve büyük ortakların pay alım/satım (Insider) bildirimlerini listele.
Inputs: hisse_kodu. Returns: result
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.
Inputs: limit, hisse_kodu. Returns: result
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.
Inputs: islem_gecmisi_json. Returns: result
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:
Ortalama / medyan / en yüksek / en düşük hedef fiyat
AL/TUT/SAT dağılımı
Konsensüs skoru (-1 ile +1 arası)
Standart sapma (analistler arası uyum derecesi)
Inputs: hisse_kodu. Returns: result
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.
Inputs: no named parameters. Returns: result
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.
Inputs: hisseler_csv, getiriler_csv, volatiliteler_csv, risk_free_rate_pct. Returns: result
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.
Inputs: sembol, gun_sayisi, mevcut_fiyat, simulasyon_sayisi, +2 more. Returns: result
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.
Inputs: sembol. Returns: result
openbb_makro_gostergelerA
OpenBB entegrasyonu ile USD/TRY, EUR/TRY, BIST100, Altın, Petrol ve S&P500 makro verilerini getir.
Inputs: no named parameters. Returns: result
portfoy_risk_analiziA
Portföyün Sharpe, Sortino, Max Drawdown risk metriklerini ve HHI yoğunlaşma skorunu hesapla.
Inputs: risk_free_rate_pct, hisseler_ve_agirliklar_csv. Returns: result
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.
Inputs: tarih, kurum_kodu, rapor_tipi. Returns: result
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.
Inputs: no named parameters. Returns: result
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.
Inputs: no named parameters. Returns: result
stres_testi_simulasyonuB
Portföyü BIST Çöküşü, Kur Şoku, Faiz Artışı ve Stagflasyon kriz senaryolarında simüle et.
Inputs: senaryo, hisseler_ve_agirliklar_csv. Returns: result
tcmb_evds_gostergelerA
TCMB EVDS ve TÜİK verileri ile Politika Faizi, TÜFE/ÜFE, Rezervler ve Kur göstergelerini raporla.
Inputs: no named parameters. Returns: result
tefas_fon_analizB
TEFAS (Türkiye Elektronik Fon Alım Satım Platformu) fon fiyatı, AUM büyüklüğü ve getiri analizi yap.
Inputs: fon_kodu. Returns: result
veri_durumuA
İndirilen raporların ve veri dizininin genel durumunu göster.
Hangi tarihlerde kaç rapor indirilmiş, dizin yapısının özeti.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Financial data and analysis tools for Turkish BIST and international markets via MCP.
Production MCP server for US equity and options intelligence: real-time IV radar, Monte Carlo simulation, options pressure, strategy backtesting, AI prediction, pre-trade risk analysis, and automated stock research reports.
Research-only MCP server: your AI as a quant research desk. 90 tools, no trades, no brokers.
Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Control Protocol server that provides access to Turkey's Public Disclosure Platform (KAP) data, including company information, financial reports, market announcements, and sector information.2-
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT
- AlicenseAqualityCmaintenanceComprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.269 npmMIT
- AlicenseAqualityDmaintenanceMCP server for listing, comparing, and analyzing Turkish TEFAS mutual funds, including performance metrics and portfolio breakdowns.6MIT