Borsa MCP provides LLM-accessible integration with Turkish and US financial markets, offering 26 unified tools that aggregate data from sources including Borsa İstanbul (BIST), Yahoo Finance, BtcTurk, Coinbase, and Turkey's Central Bank (TCMB). The server enables comprehensive financial analysis across stocks (758 BIST + NYSE/NASDAQ), technical screening (RSI, MACD, Supertrend indicators), TEFAS mutual funds (836+), cryptocurrencies, forex, commodities, and macroeconomic data, solving the problem of fragmented access to Turkish and international market information for AI-driven financial research. It operates as a remote MCP service requiring no local installation, allowing direct integration with Claude Desktop and Google Antigravity.
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.
com.mcparmory/google-sheets
domdomegg/google-sheets-mcp
henilcalagiya/google-sheets-mcp
cct15/war-dashboard-data
moooonad/mcp-google-sheets-full
io.github.br0ski777/csv-to-json