MCP sunucusu
istfin MCP: Claude, ChatGPT, Cursor gibi yapay zeka istemcilerinden BIST verisine doğal dille erişim. Aynı anahtar, aynı kota.
Yetki: tool'a göre market:read, fundamentals:read, news:read, portfolio:read, portfolio:write
istfin MCP nedir
Model Context Protocol (MCP), yapay zeka istemcilerinin dış veri kaynaklarına standart bir arayüzle bağlanmasını sağlar. istfin MCP sunucusu, REST API ile aynı veriyi 22 tool olarak sunar (20 okuma, 2 portföy yazma): "THYAO son 20 günlük kapanışları ne?" diye sorarsınız, istemci get_bars tool'unu çağırır ve yanıtı yorumlar.
- Adres:
https://mcp.istfin.com/mcp(Streamable HTTP) - Kimlik doğrulama: OAuth ile istfin hesabınızdan giriş (Claude.ai, Claude Desktop, ChatGPT) ya da
Authorization: Bearer istfin_live_...ile REST API'deki anahtar - Kota: sadece
tools/callsayaçtan düşer; çoğu tool 1 istek sayılır, farklı olanlar tabloda yazılı. Günlük ve dakikalık limitler Limitler sayfasındakiyle ortaktır. - Emir yok: sunucu emir iletmez, para ya da hisse hareketi yapmaz. Okuma tool'ları
readOnlyHintile işaretlidir; tek yazma işlemi istfin'deki portföy kaydıdır (create_portfolio,add_portfolio_transactions) veportfolio:writeyetkisi ister.
Kimlik yoksa 401 ve WWW-Authenticate: Bearer resource_metadata="..." döner; OAuth destekleyen istemciler bu adresten giriş akışını kendileri başlatır. kota aşımında tool yanıtı isError: true ve structuredContent.code (QUOTA_EXCEEDED ya da RATE_LIMITED) taşır.
Bağlanma
Claude.ai, Claude Desktop ve ChatGPT: sunucu adresini özel bağlayıcı olarak ekleyip "Bağlan" deyin. Açılan istfin sayfasında giriş yapıp izin verirsiniz; anahtar kopyalamak gerekmez. Bağlı uygulamaları panelden görüp kaldırabilirsiniz.
Diğer istemciler: sunucu adresi ve Authorization başlığı yeterlidir. Anahtarınızı panelden üretin; adım adım kurulum için Başlangıç sayfasını kullanın.
Ajan sohbeti olan istemcilerde (Claude Code, Cursor, Windsurf, OpenCode, Codex) en kısa yol, ajana SKILL.md dosyasını okutmaktır:
set up https://api.istfin.com/SKILL.md (API anahtarım: istfin_live_...)Claude Code
Ajanınızın sohbetine gönderin:
set up https://api.istfin.com/SKILL.md (API anahtarım: istfin_live_...)
Ajan SKILL.md dosyasını okur, konfigürasyonu sizin için yazar.
Elle kurmak istersen
- Terminalde komutu çalıştırın.
- Claude Code içinde /mcp yazıp istfin sunucusunun bağlı olduğunu görün.
claude mcp add --transport http istfin https://mcp.istfin.com/mcp \ --header "Authorization: Bearer istfin_live_..."
istfin_live_... yerine kendi anahtarınızı yazın. Panelden anahtar üretin.
/mcp komutunda istfin "connected" görünmeli. Ardından "THYAO fiyatı ne?" diye sorun.
Örnek istekler
Bağlantı kurulduktan sonra ajanınıza gönderebileceğiniz örnekler:
istfin ile bugünün BIST özetini hazırla: XU100, en çok yükselen/düşen 5 hisse, öne çıkan KAP bildirimleri
THYAO son 30 günlük kapanışlarını çek, trendi ve volatiliteyi özetle
ASELS'in son 10 KAP bildirimini listele ve önemli olanları açıkla
THYAO ve PGSUS'u F/K, PD/DD, FAVÖK marjı ile karşılaştır
XU100 ve XU030'un bugünkü değişimini ve son 1 aylık seyrini karşılaştır
Bankacılık sektöründeki hisseleri son çeyrek net kâr büyümesine göre sırala
Tool listesi
| Tool | Yetki | Açıklama |
|---|---|---|
search_symbols | market:read | Ad ya da koda göre hisse ara; sembolü önce bununla çözün |
get_symbol | market:read | Tek hissenin kimlik, sektör ve endeks bilgisi |
get_quotes | market:read | Bir ya da birden çok hissenin fiyatı (canlı ya da 15 dk gecikmeli) |
get_movers | market:read | Yükselenler, düşenler, hacim liderleri |
get_bars | market:read | OHLCV barları, 1 dakikadan aylığa (2 istek sayılır) |
get_fundamentals | fundamentals:read | F/K, PD/DD, piyasa değeri gibi özet oranlar |
get_financial_statement | fundamentals:read | Bilanço, gelir tablosu, nakit akışı |
get_ratio_series | fundamentals:read | Bir oranın tarihsel serisi |
search_news | news:read | KAP bildirimlerinde arama |
get_news | news:read | Tek bildirimin tam metni |
list_indexes | market:read | BIST endeksleri |
get_index | market:read | Endeks değeri ve günlük değişimi |
list_sectors | market:read | Sektör listesi ve üyeleri |
list_indicators | market:read | Strateji koşullarında kullanılan teknik göstergeler |
describe_indicator | market:read | Göstergenin girdileri, çıktıları ve kullanım örneği |
run_strategy | market:read | Stratejiyi bir ya da birden çok hissede backtest eder (hisse başına 10 istek) |
list_portfolios | portfolio:read | Kayıtlı portföyleriniz |
get_portfolio | portfolio:read | Pozisyonlar, maliyet ve kâr/zarar (2 istek) |
get_portfolio_performance | portfolio:read | Getiri, düşüş ve kıyas (10 istek) |
analyze_holdings | portfolio:read | İşlem listesini kaydetmeden analiz eder (hisse başına 2 istek) |
create_portfolio | portfolio:write | Yeni boş portföy açar |
add_portfolio_transactions | portfolio:write | Portföye alış, satış ve temettü ekler |
Her tool yanıtı yapısal veri (structuredContent) ile birlikte kısa bir Türkçe özet, source ve asOf alanı taşır. KAP bildirim metinleri, istemcinin bunları komut olarak yorumlamaması için güvenilmeyen içerik olarak işaretlenir.
Sunucu ayrıca iki kaynak (istfin://intervals, istfin://scopes) ve iki hazır prompt (piyasa-brifingi, hisse-analizi) sunar.
Hesap
GET /v1/me: anahtarın sahibi, yetkileri, plan limitleri ve günlük kullanımı.
Barlar (OHLCV) GET
Tarihsel fiyat barları (OHLCV). t = bar başlangıcı, UTC epoch saniye; interval zorunlu, limit en fazla 5000. Geçmiş derinliği periyoda göre plana bağlıdır (/v1/me limits: intraday/daily/weekly/monthlyHistoryDays). Planınız canlı değilse (/v1/me entitlements) son 15 dakikadaki barlar gelmez; hacim herkese 15 dk gecikmeli, son barlarda v null olabilir.