MCP-сервер Borsa (биржа Турции).
Borsa İstanbul (BIST) ve ABD (US) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan FastMCP sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, borsapy ve TCMB gibi kaynaklardan 26 birleşik araç ile kapsamlı finansal analiz.


✅ Kurulum Gerektirmez! Hemen Kullan!
🔗 Remote MCP Adresi: https://borsamcp.fastmcp.app/mcp
Borsa MCPhttps://borsamcp.fastmcp.app/mcpmcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:{
"mcpServers": {
"borsa-mcp": {
"serverUrl": "https://borsamcp.fastmcp.app/mcp",
"headers": {
"Content-Type": "application/json"
}
}
}
}
💡 İ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
28 Birleşik Araç ile Kapsamlı Finansal Analiz (v0.9.0):
market parametresi ileget_evds_data, ücretsiz API key)get_macro_data)get_index_data)compare_mode)get_crypto_market)include_islamic parametresi)news_id parametresi ile)get_screener_help, get_scanner_help, get_regulations| Bölüm | Açıklama |
|---|---|
| 🚀 5 Dakikada Başla | Kurulum gerektirmez - Remote MCP |
| 🎯 Temel Özellikler | 26 birleşik araç ile kapsamlı finansal analiz |
| 💻 Gelişmiş Kurulum | 5ire, Claude Desktop local kurulum |
| 🛠️ Kullanılabilir Araçlar | BIST, US, Kripto, Döviz, Fon araçları |
| 🔍 Veri Kaynakları | KAP, Yahoo Finance, BtcTurk, Coinbase, TCMB |
| 📊 Örnek Kullanım | Pratik sorgular ve analiz örnekleri |
Not: Remote MCP kullanıyorsanız bu adımları atlayabilirsiniz!
Bu bölüm, Borsa MCP'yi 5ire gibi diğer MCP istemcileriyle local olarak kullanmak isteyenler içindir.
uv Kurulumu:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"curl -LsSf https://astral.sh/uv/install.sh | shborsamcpBorsa MCPuvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
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.
Bu FastMCP sunucusu LLM modelleri için 26 birleşik araç sunar. Tüm araçlar market parametresi ile BIST ve US piyasalarını destekler.
| Araç | Açıklama | Multi-ticker |
|---|---|---|
search_symbol | Hisse, endeks, fon, kripto sembol arama | - |
get_profile | Şirket profili (sektör, açıklama, finansallar) + include_islamic | - |
get_quick_info | Hızlı metrikler (P/E, P/B, ROE, 52h aralık) | ✅ |
get_historical_data | OHLCV fiyat verileri (tarih aralığı desteği) | - |
get_technical_analysis | RSI, MACD, Bollinger Bantları, hareketli ortalamalar | - |
get_pivot_points | Destek/direnç seviyeleri (S1-S3, R1-R3) | - |
get_analyst_data | Analist derecelendirmeleri ve fiyat hedefleri | ✅ |
get_dividends | Temettü geçmişi, verim, dağıtım oranı | ✅ |
get_earnings | Kazanç takvimi, EPS geçmişi, büyüme tahminleri | ✅ |
get_financial_statements | Bilanço, gelir tablosu, nakit akışı | ✅ |
get_financial_ratios | Değerleme, Buffett, sağlık, gelişmiş metrikler | - |
get_corporate_actions | Sermaye artırımları, temettü geçmişi (BIST) | ✅ |
get_news | KAP haberleri + news_id ile detay | - |
screen_securities | 23 preset veya özel filtreler ile tarama | - |
scan_stocks | Teknik scanner (RSI, MACD, Supertrend, T3) | - |
| Araç | Açıklama |
|---|---|
get_crypto_market | Ticker, orderbook, trades, OHLC, borsa bilgileri |
| Araç | Açıklama |
|---|---|
get_fx_data | 65 para birimi, metaller, emtialar (borsapy) |
get_economic_calendar | Ekonomik olaylar (TR, US, EU, DE, GB, JP, CN) |
get_bond_yields | Devlet tahvil faizleri (TR 2Y, 5Y, 10Y) |
get_sector_comparison | Sektör karşılaştırması ve ortalama metrikler |
| Araç | Açıklama |
|---|---|
get_fund_data | TEFAS fon verileri + compare_mode ile karşılaştırma |
get_index_data | Borsa endeks verileri (BIST + US) |
| 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ı |
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.
export EVDS_API_KEY="your-key-here"
veya MCP server config'e ekle (Claude Desktop / Cursor):
{
"mcpServers": {
"borsa": {
"command": "uv",
"args": ["run", "borsa-mcp"],
"env": { "EVDS_API_KEY": "your-key-here" }
}
}
}
Örnek kullanım:
get_evds_data(action="categories") # 145 kategori
get_evds_data(action="search", keyword="dolar") # katalog araması
get_evds_data(action="series", series_code="TP.DK.USD.A.YTL", period="1y") # USD/TRY günlük
get_evds_data(action="series", series_code="TP.FG.J0", formula="yoy_pct") # TÜFE YoY%
get_evds_data(action="multi_series", series_codes=["TP.DK.USD.A.YTL","TP.DK.EUR.A.YTL"])
get_evds_data(action="datagroup_data", datagroup_code="bie_dkdovizgn") # 137 seri tek çağrıda
region=us otomatik eklenirfon_mevzuat_kisa.md - 80,820 karakter düzenleme metni# Ş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.