Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu
Borsa İstanbul (BIST) ve ABD (US) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, borsapy ve TCMB gibi kaynaklardan ile kapsamlı finansal analiz.
MCP Server for Turkish & American Stock Exchange and Fund Data
Eski adresi (borsamcp.fastmcp.app) kullanıyorsanız, yapılandırmanızı yukarıdaki yeni adresle güncelleyin. Eski adres bir süre daha ayakta kalacak ancak yalnızca bu taşınma bilgisini döndürüyor, piyasa verisi sunmuyor.
Açık kaynak projelerime sponsor olduğu için @arctcloud — Arct Cloud'a teşekkürler. Diğer MCP sunucularımı da vakit buldukça taşıyacağım.
💡 İpucu: Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Google Antigravity üzerinden Türk finans piyasalarına erişebilirsiniz!
Ö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
28 Birleşik Araç ile Kapsamlı Finansal Analiz (v0.9.0):
📈 Hisse Senetleri (BIST + US): 758 BIST + tüm NYSE/NASDAQ şirketleri, tek araçla market parametresi ile
🔍 Teknik Tarama: BIST teknik scanner (RSI, MACD, Supertrend, T3) + US screener (23 preset)
🆕 TCMB EVDS: 145 kategori, on binlerce makro seri — faiz, döviz, ödemeler dengesi, enflasyon (get_evds_data, ücretsiz API key)
🆕 Makro Veriler: TCMB enflasyon verileri ve hesaplama araçları (get_macro_data)
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.
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.
Ş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:
TEFAS fon verileri + compare_mode ile karşılaştırma
get_index_data
Borsa endeks verileri (BIST + US)
Makro & Yardım Araçları (5 araç)
Araç
Açıklama
get_macro_data
TCMB enflasyon verileri ve hesaplama (TÜFE/ÜFE, key gerekmez)
get_evds_data
TCMB EVDS — 145 kategori, on binlerce makro seri (rates, FX, BoP, expectation surveys); katalog/arama key gerekmez, veri çekme için EVDS_API_KEY env var (ücretsiz: https://evds3.tcmb.gov.tr)
get_screener_help
Screener presetleri ve filtre dokümantasyonu
get_scanner_help
BIST scanner göstergeleri ve presetler
get_regulations
Türk yatırım fonu mevzuatı
🔑 EVDS Kurulumu
get_evds_data aracının veri çekme işlemleri (series, multi_series, datagroup_data) için TCMB'den ücretsiz bir API anahtarı gerekir. Katalog gezintisi, arama ve dashboard listeleme anahtar gerektirmeden çalışır.
Filtreleme Özellikleri: Ülke bazlı filtreleme, önem seviyesi seçimi (yüksek/orta/düşük), özelleştirilebilir tarih aralıkları
Veri Detayları: Gerçek değerler, önceki dönem verileri, tahminler (mevcut olduğunda), dönem bilgileri Türkçe açıklamalar
Güncelleme Sıklığı: Gerçek zamanlı ekonomik olay takibi ve uluslararası piyasa etkisi analizi
Zaman Dilimi Desteği: Avrupa/İstanbul ana zaman dilimi ile Türk saati koordinasyonu
Veri Kalitesi: Doviz.com'un özelleşmiş finansal veri ağından profesyonel seviye uluslararası makroekonomik bilgiler
TCMB Enflasyon Verileri (Resmi Merkez Bankası)
Veri Kaynağı: Türkiye Cumhuriyet Merkez Bankası resmi enflasyon istatistikleri sayfaları
Veri Türleri:
TÜFE: Tüketici Fiyat Endeksi (2005-2025, 245+ aylık kayıt)
ÜFE: Üretici Fiyat Endeksi - Yurt İçi (2014-2025, 137+ aylık kayıt)
Güncelleme Sıklığı: Aylık (genellikle ayın ortasında resmi açıklama)
Veri Kalitesi: Resmi TCMB kaynağından web scraping ile %100 güvenilir
Performans: 2-3 saniye (1 saatlik cache ile optimize edilmiş)
Filtreleme: Enflasyon türü seçimi, tarih aralığı (YYYY-MM-DD), kayıt sayısı limiti
İstatistikler: Min/max oranlar, ortalamalar, son değerler otomatik hesaplama
Son Veriler (Mayıs 2025):
TÜFE: %35.41 (yıllık), %1.53 (aylık)
ÜFE: %23.13 (yıllık), %2.48 (aylık)
Ekonomik Analiz: ÜFE öncü gösterge olarak TÜFE hareketlerini öngörmede kullanılır
📊 Örnek Kullanım
# Şirket arama
GARAN hissesi için detaylı analiz yap
# Endeks analizi
XU100 endeksinin son 1 aylık performansını analiz et
# Tarih aralığı ile hisse analizi (YENİ!)
GARAN hissesinin 2024 yıl başından bugüne performansını analiz et
# Belirli dönem karşılaştırması (YENİ!)
THYAO'nun 2023 ve 2024 yıllarının ilk çeyreklerini karşılaştır
# Teknik analiz
ASELS için kapsamlı teknik analiz ve al-sat sinyalleri ver
# KAP haberleri
THYAO için son 5 KAP haberini getir ve ilkinin detayını analiz et
# Katılım finans
ARCLK'nın katılım finans uygunluğunu kontrol et
# Sektör karşılaştırması
Bankacılık sektöründeki ana oyuncuları karşılaştır: GARAN, AKBNK, YKBNK
# US hisse analizi
Apple (AAPL) hissesinin son 3 aylık performansını analiz et
# US finansal tablolar
Microsoft'un son yıllık bilançosunu getir
# US Buffett değer analizi
Amazon için Buffett değer analizi yap
# US endeks arama
Teknoloji sektörü endekslerini ara
# US sektör karşılaştırması
AAPL, MSFT, GOOGL şirketlerini sektör bazında karşılaştır
# US finansal sağlık analizi
Tesla için kapsamlı finansal sağlık analizi yap
# US hisse tarama (screener)
Büyük piyasa değerli (large cap) ABD hisselerini listele
# US değer hisseleri tarama
Düşük F/K oranına sahip (P/E < 15) değer hisselerini bul
# US yüksek temettü hisseleri
%5'ten fazla temettü veren ABD hisselerini ara
# US sektör bazlı tarama
Teknoloji sektöründeki büyük cap hisseleri listele
# US ETF tarama
10 milyar dolardan fazla AUM'a sahip büyük ETF'leri göster
# US özel filtre taraması
Piyasa değeri 100 milyar dolar üstü ve ROE > %20 olan hisseleri bul
# BIST hisse tarama (screener) - YENİ!
Yüksek temettü veren BIST hisselerini listele
# BIST düşük F/K tarama
F/K oranı 10'dan düşük BIST hisselerini bul
# BIST yüksek ROE tarama
ROE oranı %15'ten yüksek şirketleri ara
# BIST yabancı favorileri
Yabancı yatırımcı oranı %40'tan fazla olan hisseleri göster
# BIST momentum tarama
Yükseliş potansiyeli %20'den fazla olan hisseleri listele
# BIST özel filtre taraması
Piyasa değeri 10 milyar TL üstü ve temettü verimi %3'ten fazla olan hisseleri bul
# BIST analist tavsiyeleri
AL önerisi alan BIST hisselerini listele
# Fon arama ve analizi
"altın" fonları ara ve en iyi performans gösteren 3 tanesini karşılaştır
# Fon portföy analizi
AAK fonunun son 6 aylık portföy dağılım değişimini analiz et
# Fon mevzuat sorguları
Yatırım fonlarında türev araç kullanım limitleri nelerdir?
# Türk kripto para analizi
Bitcoin'in TRY cinsinden son 1 aylık fiyat hareketlerini analiz et
# Türk kripto piyasa takibi
BtcTurk'te en çok işlem gören kripto çiftleri listele ve fiyat değişimlerini göster
# Türk kripto emir defteri analizi
BTCTRY çiftinin emir defterini görüntüle ve derinlik analizini yap
# Global kripto para analizi
Bitcoin'in USD cinsinden Coinbase'deki son 1 aylık fiyat hareketlerini analiz et
# Global kripto piyasa takibi
Coinbase'de en popüler USD/EUR kripto çiftlerini listele ve global piyasa trendlerini göster
# Global kripto emir defteri analizi
BTC-USD çiftinin Coinbase emir defterini görüntüle ve global likidite analizini yap
# Çapraz piyasa kripto analizi
Bitcoin fiyatını Türk (BTCTRY) ve global (BTC-USD) piyasalarda karşılaştır
# Arbitraj fırsatı analizi
ETH fiyatlarını BtcTurk (ETHUSDT) ve Coinbase (ETH-USD) arasında karşılaştırarak arbitraj fırsatlarını tespit et
# BtcTurk kripto teknik analiz
BTCTRY çiftinin günlük teknik analizini yap ve al-sat sinyallerini değerlendir
# Coinbase global kripto teknik analiz
BTC-USD çiftinin 4 saatlik teknik analizini yap ve RSI, MACD durumunu analiz et
# Çapraz piyasa teknik analiz karşılaştırması
Bitcoin'in hem Türk piyasasında (BTCTRY) hem global piyasada (BTC-USD) teknik analiz sinyallerini karşılaştır
# Global kripto teknik analiz
ETH-EUR çiftinin günlük Bollinger Bantları ve hareketli ortalama durumunu analiz et
# Döviz kuru analizi
USD/TRY kurunun güncel durumunu ve son 1 saatteki dakikalık hareketlerini analiz et
# Altın fiyat takibi
Gram altının TRY cinsinden güncel fiyatını al ve son 30 dakikadaki değişimini göster
# Uluslararası altın karşılaştırması
Türk gram altını ile uluslararası ons altın fiyatlarını karşılaştır
# Emtia fiyat analizi
Brent petrolün son 6 aylık OHLC verilerini al ve fiyat trendini analiz et
# Kıymetli maden portföy takibi
Altın, gümüş ve platinyum fiyatlarının güncel durumunu ve haftalık performansını karşılaştır
# Çapraz döviz analizi
EUR/TRY ve GBP/TRY kurlarının güncel durumunu karşılaştır ve arbitraj fırsatlarını değerlendir
# Yakıt fiyat takibi
Dizel, benzin ve LPG fiyatlarının güncel durumunu ve haftalık değişimlerini analiz et
# Yakıt fiyat karşılaştırması
Son 3 aylık dizel ve benzin fiyat trendlerini karşılaştır ve analiz et
# Haftalık ekonomik takvim (çoklu ülke)
Bu haftanın önemli ekonomik olaylarını TR,US,DE için listele ve piyasa etkilerini değerlendir
# Tek ülke ekonomik takip
Sadece Almanya'nın bu ayki ekonomik verilerini getir ve analiz et
# Çoklu ülke ekonomik karşılaştırma
TR,US,GB,FR,DE ülkelerinin bu haftaki tüm ekonomik verilerini karşılaştır
# Ekonomik veri analizi
Türkiye ve ABD'nin son çeyrek GDP büyüme verilerini karşılaştır ve trend analizini yap
# TCMB TÜFE enflasyon analizi
Son 2 yılın tüketici enflasyon verilerini getir ve trend analizini yap
# TCMB ÜFE enflasyon analizi
Üretici enflasyonunun son 1 yılını analiz et ve TÜFE ile karşılaştır
# Enflasyon dönemsel analizi
2022-2024 yüksek enflasyon dönemini hem TÜFE hem ÜFE açısından analiz et
# TÜFE vs ÜFE karşılaştırması
Son 12 aylık TÜFE ve ÜFE verilerini karşılaştır ve fiyat geçişkenliğini analiz et
# Güncel enflasyon durumu
Son 6 aylık hem tüketici hem üretici enflasyon verilerini al ve Merkez Bankası hedefleriyle karşılaştır
# TCMB enflasyon hesaplayıcı analizi
2020'deki 100 TL'nin bugünkü satın alma gücünü hesapla
# Yüksek enflasyon dönemi analizi
2021-2024 yüksek enflasyon döneminde 1000 TL'nin değişimini hesapla ve kümülatif enflasyon etkisini analiz et
# Uzun dönemli satın alma gücü analizi
2010'dan bugüne 5000 TL'lik maaşın satın alma gücündeki değişimi hesapla
# Kısa dönemli enflasyon hesaplaması
Son 6 aylık enflasyon etkisini hesapla ve yıllık bazda projeksiyon yap
# Ekonomik kriz dönemleri karşılaştırması
2001, 2008 ve 2018 ekonomik krizlerinin enflasyon etkilerini karşılaştır
# Kontrat endeksleme hesaplaması
Kira sözleşmelerinin enflasyon ayarlaması için gerekli artış oranını hesapla
📜 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.
B
Borsa
saidsurucu·656 étoiles·
MCP Server for Turkish & American Stock Exchange and Fund Data
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Questions
Comment installer Borsa ?
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Borsa nécessite-t-il une clé API ?
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Quel transport Borsa utilise-t-il ?
Borsa s'exécute en local via stdio.
Quand Borsa a-t-il été vérifié pour la dernière fois ?
Dernière vérification : 2026-10-28. MCP Server for Turkish & American Stock Exchange and Fund Data