Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu

Borsa İstanbul (BIST) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan FastMCP sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, Doviz.com ve TCMB gibi kaynaklardan 50 araçla kapsamlı finansal analiz.

ornek

fon ornek

⚠️ Önemli Uyarılar

LLM'ler halüsinasyon yapabilir - Verileri mutlaka doğrulayın
Yatırım tavsiyesi değildir - Profesyonel danışmanlık alın
Eğitim amaçlıdır - Sorumluluk size aittir

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://borsamcp.fastmcp.app/mcp

Claude Desktop ile Kullanım

Claude Desktop'ı açın
Settings → Connectors → Add Custom Connector
Bilgileri girin:
- Name: Borsa MCP
- URL: https://borsamcp.fastmcp.app/mcp
Add butonuna tıklayın
Hemen kullanmaya başlayın! 🎉

Örnek Sorular:

GARAN hissesinin son 1 aylık performansını analiz et
XU100 endeksinin bugünkü durumunu göster
Bitcoin'in TRY fiyatını kontrol et

🎯 Temel Özellikler

50 Araç ile Kapsamlı Finansal Analiz:

📈 BIST Hisseleri: 758 şirket, finansal tablolar, teknik analiz, analist raporları, KAP haberleri
🆕 Tarih Aralığı: Belirli tarihler arası geçmiş veri sorgulaması (örn: "2024-01-01" - "2024-12-31")
🎯 Pivot Points: 3 direnç & 3 destek seviyesi hesaplama (klasik pivot formülü)
📊 BIST Endeksleri: XU100, XBANK, XK100 ve tüm endeksler için tam destek
💡 Değer Yatırımı: Warren Buffett analizi ve konsolide finansal sağlık araçları (ROE, ROIC, Altman Z-Score, 75-85% daha hızlı)
💰 TEFAS Fonları: 800+ fon, performans analizi, portföy dağılımı, karşılaştırma
₿ Kripto Paralar: BtcTurk (TRY) ve Coinbase (USD/EUR) ile Türk ve global piyasalar
💱 Döviz & Emtia: USD, EUR, altın, petrol ve 28+ varlık takibi (Doviz.com)
📅 Ekonomik Takvim: TR, US, EU ve 30+ ülke için makroekonomik veriler
📉 TCMB Enflasyon: TÜFE/ÜFE resmi enflasyon verileri ve hesaplama araçları
☪️ Katılım Finans: İslami finans uygunluk verileri
⚡ LLM Optimizasyonu: Hızlı işleme ve domain-spesifik araç seçimi

📑 İçindekiler

🚀 5 Dakikada Başla (Remote MCP) - Kurulum gerektirmez!
🎯 Temel Özellikler

💻 Gelişmiş Kurulum (İsteğe Bağlı)

5ire ve Diğer MCP İstemcileri
Claude Desktop Manuel/Local Kurulum

🛠️ Kullanılabilir Araçlar

Temel Şirket & Finansal Veriler
Gelişmiş Analiz Araçları
KAP & Haberler
BIST Endeks Araçları
Katılım Finans
Değer Yatırımı & Finansal Sağlık
TEFAS Fon Araçları
BtcTurk Kripto Araçları
Coinbase Global Kripto Araçları
Dovizcom Döviz & Emtia Araçları
Ekonomik Takvim
TCMB Enflasyon Araçları

🔍 Veri Kaynakları & Kapsam

KAP (Kamuyu Aydınlatma Platformu)
Yahoo Finance
Mynet Finans
TEFAS
BtcTurk & Coinbase
Dovizcom
TCMB

📊 Örnek Kullanım

Hisse Senedi Analizleri
Fon Analizleri
Kripto Para Analizleri
Döviz & Emtia Analizleri
Ekonomik Takvim
Enflasyon Analizleri

💻 Gelişmiş Kurulum (İsteğe Bağlı)

Not: Remote MCP kullanıyorsanız bu adımları atlayabilirsiniz!

5ire ve Diğer MCP İstemcileri için Local Kurulum

Bu bölüm, Borsa MCP'yi 5ire gibi diğer MCP istemcileriyle local olarak kullanmak isteyenler içindir.

Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
uv Kurulumu:
- Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın: curl -LsSf https://astral.sh/uv/install.sh | sh
Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.
İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
Tools menüsüne girin. +Local veya New yazan butona basın.
- Tool Key: borsamcp
- Name: Borsa MCP
- Command:
```
uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
```
- Save butonuna basarak kaydedin.
Şimdi Tools altında Borsa MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
Artık Borsa MCP ile konuşabilirsiniz.

Claude Desktop için Local Kurulum

Not: Remote MCP daha kolay bir seçenektir. Sadece local kurulum yapmak istiyorsanız bu adımları izleyin.

Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.
Claude Desktop Settings -> Developer -> Edit Config.

Açılan claude_desktop_config.json dosyasına mcpServers altına ekleyin. UYARI: // ile başlayan yorum satırını silmelisiniz:

{
  "mcpServers": {
    // ... (varsa diğer sunucularınız) ...
    "Borsa MCP": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/saidsurucu/borsa-mcp",
        "borsa-mcp"
      ]
    }
  }
}

Claude Desktop'ı kapatıp yeniden başlatın.

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:

Temel Şirket & Finansal Veriler

find_ticker_code: Güncel BIST şirketleri arasında ticker kodu arama.
get_sirket_profili: Detaylı şirket profili.
get_bilanco: Bilanço verileri (yıllık/çeyreklik).
get_kar_zarar_tablosu: Kar-zarar tablosu (yıllık/çeyreklik).
get_nakit_akisi_tablosu: Nakit akışı tablosu (yıllık/çeyreklik).
get_finansal_veri: Geçmiş OHLCV verileri (hisse senetleri ve endeksler için). YENİ: Belirli tarih aralığı desteği (örn: start_date="2024-01-01", end_date="2024-12-31") veya dönem modu (1mo, 1y vb.).

Gelişmiş Analiz Araçları

get_analist_tahminleri: Analist tavsiyeleri, fiyat hedefleri ve trendler.
get_temettu_ve_aksiyonlar: Temettü geçmişi ve kurumsal işlemler.
get_hizli_bilgi: Hızlı finansal metrikler (P/E, P/B, ROE vb.).
get_kazanc_takvimi: Kazanç takvimi ve büyüme verileri.
get_teknik_analiz: Kapsamlı teknik analiz ve göstergeler.
get_pivot_points: Günlük pivot noktaları ile 3 direnç ve 3 destek seviyesi hesaplama.
get_sektor_karsilastirmasi: Sektör analizi ve karşılaştırması.

KAP & Haberler

get_kap_haberleri: Son KAP haberleri ve resmi şirket duyuruları.
get_kap_haber_detayi: Detaylı KAP haber içeriği (Markdown formatında).

BIST Endeks Araçları

get_endeks_kodu: Güncel BIST endeks listesinde endeks kodu arama.
get_endeks_sirketleri: Belirli endeksteki şirketlerin listesi.

Katılım Finans

get_katilim_finans_uygunluk: KAP Katılım finans uygunluk verileri ve katılım endeksi üyeliği.

Değer Yatırımı & Finansal Sağlık Araçları

Warren Buffett Değer Analizi:

calculate_buffett_value_analysis: Tek çağrıda 4 Buffett metriği (Owner Earnings, OE Yield, DCF Fisher, Safety Margin) - Genel skor: STRONG_BUY/BUY/HOLD/AVOID

Finansal Sağlık Analizi (Konsolide):

calculate_core_financial_health: 5 temel metrik tek çağrıda (ROE, ROIC, Borç Oranları, FCF Marjı, Kazanç Kalitesi) - Skor: STRONG/GOOD/AVERAGE/WEAK - 75-85% daha hızlı
calculate_advanced_metrics: 2 gelişmiş metrik (Altman Z-Score iflas riski + Enflasyona göre düzeltilmiş reel büyüme) - Stabilite: SAFE/GREY/DISTRESS - 75-85% daha hızlı

Kapsamlı Analiz:

calculate_comprehensive_analysis: 11 metrikte tam finansal sağlık değerlendirmesi (Likidite, Karlılık, Değerleme, Kompozit Skorlar)

TEFAS Fon Araçları

search_funds: Türk yatırım fonları arama (kategori filtreleme ve performans metrikleri ile).
get_fund_detail: Kapsamlı fon bilgileri ve analitiği.
get_fund_performance: Resmi TEFAS BindHistoryInfo API ile geçmiş fon performansı.
get_fund_portfolio: Resmi TEFAS BindHistoryAllocation API ile fon portföy dağılımı.
compare_funds: Resmi TEFAS karşılaştırma API ile çoklu fon karşılaştırması.

Fon Mevzuat Araçları

get_fon_mevzuati: Türk yatırım fonları mevzuat rehberi (hukuki uyumluluk için).

BtcTurk Kripto Para Araçları (Türk Piyasası)

get_kripto_exchange_info: Tüm kripto çiftleri, para birimleri ve borsa operasyonel durumu.
get_kripto_ticker: Kripto çiftler için gerçek zamanlı fiyat verileri (çift veya kote para birimi filtresi ile).
get_kripto_orderbook: Güncel alış/satış emirlerini içeren emir defteri derinliği.
get_kripto_trades: Piyasa analizi için son işlem geçmişi.
get_kripto_ohlc: Kripto grafikleri ve teknik analiz için OHLC verileri.
get_kripto_kline: Çoklu zaman çözünürlükleri ile Kline (mum grafik) verileri.
get_kripto_teknik_analiz: Türk kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.

Coinbase Global Kripto Para Araçları (Uluslararası Piyasalar)

get_coinbase_exchange_info: Global işlem çiftleri ve para birimleri (USD/EUR piyasaları ile).
get_coinbase_ticker: Uluslararası piyasalar için gerçek zamanlı global kripto fiyatları (USD/EUR).
get_coinbase_orderbook: USD/EUR alış/satış fiyatları ile global emir defteri derinliği.
get_coinbase_trades: Çapraz piyasa analizi için son global işlem geçmişi.
get_coinbase_ohlc: USD/EUR kripto grafikleri için global OHLC verileri.
get_coinbase_server_time: Coinbase sunucu zamanı ve API durumu.
get_coinbase_teknik_analiz: Global kripto piyasaları için RSI, MACD, Bollinger Bantları ve al-sat sinyalleri ile kapsamlı teknik analiz.

Dovizcom Döviz & Emtia Araçları (Türk & Uluslararası Piyasalar)

get_dovizcom_guncel: Güncel döviz kurları ve emtia fiyatları (USD, EUR, GBP, gram-altın, ons, BRENT, dizel, benzin, LPG).
get_dovizcom_dakikalik: Gerçek zamanlı izleme için dakikalık veriler (60 veri noktasına kadar).
get_dovizcom_arsiv: Teknik analiz ve trend araştırması için tarihsel OHLC verileri.

Dovizcom Ekonomik Takvim Araçları

get_economic_calendar: Çoklu ülke ekonomik takvimi (TR,US varsayılan) - GDP, enflasyon, istihdam verileri ve makroekonomik olaylar.

TCMB Enflasyon Araçları

get_turkiye_enflasyon: Resmi TCMB TÜFE/ÜFE enflasyon verileri - TÜFE: tüketici fiyatları (2005-2025, 245+ kayıt), ÜFE: üretici fiyatları (2014-2025, 137+ kayıt) - yıllık/aylık oranlar, tarih aralığı filtreleme, istatistiksel özet.
get_enflasyon_hesapla: TCMB resmi enflasyon hesaplama API'si - iki tarih arası kümülatif enflasyon hesaplama, sepet değeri analizi, satın alma gücü kaybı/kazancı, ortalama yıllık enflasyon, TÜFE endeks değerleri.