İçeriğe geç

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/call sayaç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ı readOnlyHint ile işaretlidir; tek yazma işlemi istfin'deki portföy kaydıdır (create_portfolio, add_portfolio_transactions) ve portfolio:write yetkisi 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
  1. Terminalde komutu çalıştırın.
  2. 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.

Nasıl doğrulanır

/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:

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

XU100 ve XU030'un bugünkü değişimini ve son 1 aylık seyrini karşılaştır

Sektör

Bankacılık sektöründeki hisseleri son çeyrek net kâr büyümesine göre sırala

Tool listesi

ToolYetkiAçıklama
search_symbolsmarket:readAd ya da koda göre hisse ara; sembolü önce bununla çözün
get_symbolmarket:readTek hissenin kimlik, sektör ve endeks bilgisi
get_quotesmarket:readBir ya da birden çok hissenin fiyatı (canlı ya da 15 dk gecikmeli)
get_moversmarket:readYükselenler, düşenler, hacim liderleri
get_barsmarket:readOHLCV barları, 1 dakikadan aylığa (2 istek sayılır)
get_fundamentalsfundamentals:readF/K, PD/DD, piyasa değeri gibi özet oranlar
get_financial_statementfundamentals:readBilanço, gelir tablosu, nakit akışı
get_ratio_seriesfundamentals:readBir oranın tarihsel serisi
search_newsnews:readKAP bildirimlerinde arama
get_newsnews:readTek bildirimin tam metni
list_indexesmarket:readBIST endeksleri
get_indexmarket:readEndeks değeri ve günlük değişimi
list_sectorsmarket:readSektör listesi ve üyeleri
list_indicatorsmarket:readStrateji koşullarında kullanılan teknik göstergeler
describe_indicatormarket:readGöstergenin girdileri, çıktıları ve kullanım örneği
run_strategymarket:readStratejiyi bir ya da birden çok hissede backtest eder (hisse başına 10 istek)
list_portfoliosportfolio:readKayıtlı portföyleriniz
get_portfolioportfolio:readPozisyonlar, maliyet ve kâr/zarar (2 istek)
get_portfolio_performanceportfolio:readGetiri, düşüş ve kıyas (10 istek)
analyze_holdingsportfolio:readİşlem listesini kaydetmeden analiz eder (hisse başına 2 istek)
create_portfolioportfolio:writeYeni boş portföy açar
add_portfolio_transactionsportfolio:writePortfö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.

Bu sayfada