istfin (Borsa Istanbul / BIST MCP)
Licensed Borsa Istanbul (BIST) data for Claude, ChatGPT and Cursor: live or 15-min delayed prices, OHLCV bars, financial statements, ratios, KAP filings, backtests and portfolio tracking. OAuth.
Hosted MCP Server
npx add-mcp 'https://mcp.istfin.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Borsa MCP: Claude ve ChatGPT’ye Borsa İstanbul verisi
istfin Borsa MCP sunucusu, yapay zeka asistanınıza Borsa İstanbul lisanslı verisini bağlar. BIST hisselerini doğal dille sorun: fiyat, OHLC bar, bilanço, oran ve KAP bildirimi. Aboneliğe dahil.
https://mcp.istfin.com/mcp
Neler sorabilirsiniz
Bağlandıktan sonra asistanınıza şöyle yazın:
Günlük brifing
“istfin ile bugünün BIST özetini hazırla: XU100, en çok yükselen/düşen 5 hisse, öne çıkan KAP bildirimleri”
Fiyat ve trend
“THYAO son 30 günlük kapanışlarını çek, trendi ve volatiliteyi özetle”
KAP takibi
“ASELS'in son 10 KAP bildirimini listele ve önemli olanları açıkla”
Temel analiz
“THYAO ve PGSUS'u F/K, PD/DD, FAVÖK marjı ile karşılaştır”
Endeks
“XU030 bileşenlerini ağırlığa göre sırala, ilk 10'un günlük değişimini ver”
Sektör
“Bankacılık sektöründeki hisseleri son çeyrek net kâr büyümesine göre sırala”
22 araç
Her araç yapısal veri ile birlikte kısa bir Türkçe özet, kaynak ve zaman bilgisi döner.
| Araç | Ne yapar |
|---|---|
| search_symbols | Ad ya da koda göre hisse arar |
| get_symbol | Hissenin kimlik, sektör ve endeks bilgisi |
| get_quotes | Bir ya da birden çok hissenin fiyatı (canlı ya da 15 dk gecikmeli) |
| get_movers | Yükselenler, düşenler, hacim liderleri |
| get_bars | OHLCV barları, 1 dakikadan aylığa |
| get_fundamentals | F/K, PD/DD, piyasa değeri gibi özet oranlar |
| get_financial_statement | Bilanço, gelir tablosu, nakit akışı |
| get_ratio_series | Bir oranın tarihsel serisi |
| search_news | KAP bildirimlerinde arama |
| get_news | Tek bildirimin tam metni |
| list_indexes | BIST endeksleri |
| get_index | Endeks değeri ve bileşenleri |
| list_sectors | Sektör listesi ve üyeleri |
| list_indicators | Strateji koşullarında kullanılan teknik göstergeler |
| describe_indicator | Göstergenin girdileri, çıktıları ve kullanım örneği |
| run_strategy | Stratejiyi bir ya da birden çok hissede backtest eder |
| list_portfolios | Kayıtlı portföyleriniz |
| get_portfolio | Portföy pozisyonları, maliyet ve kâr/zarar |
| get_portfolio_performance | Portföy getirisi, düşüş ve kıyas |
| analyze_holdings | İşlem listesini kaydetmeden analiz eder |
| create_portfolio | Yeni boş portföy açar |
| add_portfolio_transactions | Portföye alış, satış ve temettü ekler |
Teknik ayrıntılar, kota ve hata kodları: MCP dokümantasyonu.
Güvenli tasarım
Salt-okunur
Emir yok, hesap değişikliği yok. Araçlar istemciye readOnly olarak bildirilir.
OAuth ile izin
Claude ve ChatGPT anahtarsız bağlanır: istfin hesabınızla giriş yapıp izin verirsiniz. Bağlantıyı panelden tek tıkla kaldırırsınız.
REST ile aynı veri
Aynı lisanslı veri, aynı kota. KAP metinleri güvenilmeyen içerik olarak işaretlenir; asistan onları komut sanmaz.
Diğer BIST MCP’lerinden farkı
Açık kaynak MCP sunucularının çoğu web sitelerinden kazıma yapar ve kaynak site değişince bozulur. istfin MCP lisanslı veriyi, REST API ile aynı altyapıdan sunar.
Sık sorulanlar
MCP nedir?
Model Context Protocol (MCP), yapay zeka asistanlarının dış veri kaynaklarına standart bir arayüzle bağlanmasını sağlayan açık bir protokoldür. istfin MCP sunucusu, Claude ya da ChatGPT gibi bir asistanın Borsa İstanbul verisini kendi başına çekmesini sağlar.
Borsa İstanbul için MCP sunucusu var mı?
Evet. istfin MCP (https://mcp.istfin.com/mcp) Borsa İstanbul lisanslı verisini (canlı ya da 15 dk gecikmeli) 22 araç: 20 okuma, 2 portföy yazma aracıyla sunar. Claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code, Claude Code, Windsurf, Gemini CLI, Codex ve OpenCode ile çalışır.
MCP ayrıca ücretli mi?
Hayır. MCP istfin API aboneliğine dahildir ve REST API ile aynı günlük kotayı paylaşır. Araç çağrıları kotadan düşer; çoğu araç 1 istek, get_bars 2, backtest hisse başına 10 istek sayılır.
Veri canlı mı?
Planınıza bağlı: Canlı planda fiyat ve endeks canlı, Temel planda 15 dk gecikmeli; hacim iki planda da 15 dk gecikmeli. MCP, REST API ile aynı lisanslı Borsa İstanbul verisini kullanır. Her araç yanıtı verinin kaynağını ve zamanını (asOf) taşır.
Asistan benim adıma emir verebilir mi?
Hayır. istfin MCP emir iletmez, para ya da hisse hareketi yapmaz. Tek yazma işlemi istfin’deki portföy kaydınızdır: portföy açma ve işlem ekleme, yalnızca bağlantıya yazma izni verdiyseniz.
Asistanın cevapları yatırım tavsiyesi mi?
Hayır. istfin veri sağlar; asistanın yorumları yatırım danışmanlığı değildir. Karar vermeden önce veriyi kendiniz doğrulayın.