BIST MCP Sunucusu
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
BIST MCP Sunucusu
Borsa İstanbul verisini LLM'lere açan, 18 araçlı bir Model Context Protocol sunucusu. Claude Desktop gibi herhangi bir MCP istemcisine bağlanır; model hisse fiyatı, finansal tablo, oran, temettü, KAP bildirimi, teknik analiz ve tarama sorularını bu araçları çağırarak cevaplar.
Veri kaynakları: İş Yatırım (finansal tablolar), KAP (bildirimler), yfinance (fiyat, OHLCV, döviz/altın) ve TCMB EVDS (makro göstergeler).
Araçlar
Hisse (10): detayli_analiz · hisse_ara · anlik_fiyat · gecmis_fiyat · sirket_profili ·
finansal_tablo · finansal_oranlar · temettu_gecmisi · kap_bildirimleri ·
kap_bildirim_detay
Analiz (6): yonlu_hacim · teknik_analiz · hisse_karsilastir · sektor_karsilastirma ·
hisse_tarama · endeks_verisi
Makro (2): doviz_altin · makro_gosterge
Related MCP server: market-pulse
Kurulum
Python 3.10+ gerekir.
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
Copy-Item .env.example .env # sonra .env'i doldurLinux / macOS:
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env.env alanları:
Alan | Zorunlu | Açıklama |
| Hayır | TCMB EVDS anahtarı. Yalnızca |
| Hayır | Varsayılan |
.env,*.dbve*.logdosyaları.gitignore'da. Gerçek anahtarı.env.example'a yazma.
Çalıştırma
Sunucu stdio üzerinden konuşur; elle başlatmak yerine bir MCP istemcisine bağlanır:
python -m bist_mcp.sunucuİlk açılışta proje kökünde onbellek.db, gorunum.db ve bist-mcp.log
oluşur.
Claude Desktop'a bağlama
claude_desktop_config.json dosyasına ekle. Yolları kendi klonladığın klasöre
göre değiştir:
{
"mcpServers": {
"bist": {
"command": "C:/yol/bistmcp/.venv/Scripts/python.exe",
"args": ["-m", "bist_mcp.sunucu"],
"cwd": "C:/yol/bistmcp",
"env": {
"PYTHONIOENCODING": "utf-8",
"PYTHONPATH": "C:/yol/bistmcp"
}
}
}
}pythonyerine mutlak yol kullan. Windows'ta PATH'tekipython, Microsoft Store'un sahtepython.exe'sine düşebiliyor ve sunucu "Server disconnected" ile anında kapanıyor.cwdönemli:.envve veritabanları buradan okunur.Yapılandırma değişikliği Claude Desktop yeniden başlatılınca geçerli olur.
Test
$env:PYTHONIOENCODING = "utf-8"
python -m pytest # hızlı testler: ağ yok
python -m pytest -m network # canlı veri kaynağına çıkan testlerWindows konsolu cp1252 kullandığı için PYTHONIOENCODING gerekir; yoksa
Türkçe karakterler log'a yazılırken UnicodeEncodeError verir.
Veri kuralları
Her kural canlı ölçülmüş bir hataya karşılık gelir ve regresyon testi vardır. En önemli ikisi:
Oranlar TL bazında hesaplanır, hazır alan okunmaz. İş Yatırım yalnızca finansal tabloları verir; fiyat yfinance'ten gelir. PD/DD ve F/K bu iki kaynağın TL rakamlarıyla
hesap.py'de hesaplanır. yfinance'inpriceToBook,trailingPE,dividendYieldalanları kullanılmaz. Gerekçe: THYAO finansallarını USD raporluyor, hissesi TRY işlem görüyor; yfinance TL fiyatı USD defter değerine bölüp PD/DD için 18,64 diyor, gerçek değer 0,38 (49 kat hata).Özkaynak stok, net kâr akıştır. Özkaynak için en güncel bilanço, net kâr için son 12 ay (TTM) kullanılır:
TTM = geçen yıl yıllık − geçen yıl aynı kümülatif + bu yıl kümülatif. Ölçüldü (BETAE): yıllık rakamlarla PD/DD 9,08 ve F/K 30,32 çıkıyordu; doğru değerler 5,59 ve 44,27.
Hız sınırları ve önbellek
KAP ve İş Yatırım için 2 istek/sn. KAP'ta API çağrısından önce
/tr/bildirim-sorgu'ya GET ile oturum çerezi alınır; yoksa WAF bağlantıyı
~6 saniyede düşürür.
Önbellek tembeldir: hiçbir şeyi kendiliğinden çekmez, yalnızca sorulduğunda çeker ve TTL boyunca saklar. Tek istisna tarama tablosudur.
Tarama tablosu
hisse_tarama ve sektor_karsilastirma tüm evrenin verisine ihtiyaç duyar.
Her soruda 630 şirketi çekmek mümkün olmadığı için sunucu tabloyu arka planda
iki kademede taze tutar:
Kademe | Süre | İstek | Ne çeker |
Günlük | ~40 sn | 1 | Fiyat + temettü + hacim (tek toplu indirme) |
Haftalık | ~15 dk | ~1.300 | Üstüne İş Yatırım finansalları + hisse adedi/sektör |
Soru geldiğinde tablo hazırdır ve hisse_tarama doğrudan SQLite'tan okur.
Likidite filtresi:
hacim_minparametresi, son 60 işlem gününün ortalama TL işlem hacmiyle süzer. Böylece günde birkaç lot işlem gören kabuk şirketler listenin başına çıkmaz.Çok düşük F/K bir tuzaktır: "F/K < 10" sorgusunun başını holdingler, GYO'lar ve yatırım ortaklıkları doldurur (ör. bir girişim sermayesi ortaklığında F/K 0,21; "kâr" portföy yeniden değerleme kazancı). Satırlar gizlenmez, ama araç açıklaması modeli uyarır. İşletme kârlılığı aranıyorsa
fk_min=3gibi bir alt sınır daha anlamlı sonuç verir.
Tam evren denetimi (630 işlem gören hisse)
Durum | Sayı |
Sağlıklı | 566 |
Kaynakta finansal tablo yok | 21 |
İki kaynak hisse adedinde ayrışıyor (İş Yatırım seçilir) | 28 |
Oran olağandışı (uyarı notuyla döner) | 15 |
Bilinen eksikler
makro_gostergeşu an çalışmıyor. Sebep anahtar değil, TCMB'nin API değişikliği:evds2.tcmb.gov.trartıkevds3'e yönlendiriyor ve servis yolu JSON yerine HTML döndürüyor. Araç çökmez, durumu açıklayan bir mesaj döner. Doğru yol bulununcabist_mcp/kaynaklar/tcmb.pyiçindekiEVDS_KOKgüncellenmeli. Döviz, altın ve emtiadoviz_altinüzerinden (yfinance, anahtarsız) çalışır.Aynı anda birden fazla sunucu süreci çalıştırma. Her süreç açılışta 630 hisselik tazeleme yapar; birkaç süreç çakışınca Yahoo "Too Many Requests" veriyor.
İlk açılışta tarama tablosu ~15 dakikada kurulur. O bitene kadar
hisse_tarama"Tarama tablosu henuz kurulmadi" hatası döner; diğer 17 araç hemen çalışır.Çeyreklik verisi eksik ~%27 hissede net kâr kümülatif formülden gelir. yfinance bazı şirketlerde Q3'ü hiç vermiyor (ör. ASELS, FROTO, EREGL).
Yabancı para raporlayan 4 şirkette (THYAO, TAVHL, ENKAI, DOCO) net kâr kümülatif formülden gelir; ör. TAVHL'in F/K'sı ~%9,5 düşük çıkıyor.
Uyarı
Bu sunucu yatırım tavsiyesi vermez. Veriler üçüncü taraf kaynaklardan gelir ve gecikmeli ya da hatalı olabilir.
Lisans
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
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.
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
Financial data and analysis tools for Turkish BIST and international markets via MCP.
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables MCP-compatible applications to access Borsa Istanbul KAP disclosures and Yahoo Finance market data, including prices, financial statements, ratios, analyst estimates, and news.2512 PyPIMIT
- AlicenseAqualityBmaintenanceEnables Claude or any MCP host to access live market data—quotes, history, technical indicators, and NYSE status—and answer natural-language questions about stocks.4MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through a standardized MCP interface. It provides 250+ tools across categories such as financial statements, quotes, technical indicators, ETFs, crypto, forex, commodities, economics, and SEC filings.360 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, and economics. Supports dynamic, static, or full toolset loading over HTTP/SSE for Claude and other MCP clients.360 npmApache 2.0