saidsurucu/borsa-mcp

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.
## ⚠️ Ö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
## 📢 Sunucu Taşındı
Borsa MCP sunucusu artık https://borsa.surucu.dev/mcp adresinde.
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.
Siz de SAID35 koduyla %35 indirimli kullanabilirsiniz: https://arct.cloud/?ref=x-promo-4exe09
## 🚀 5 Dakikada Başla (Remote MCP)
✅ Kurulum Gerektirmez! Hemen Kullan!
🔗 Remote MCP Adresi: https://borsa.surucu.dev/mcp
### Claude Desktop ile Kullanım (Ücretli abonelik gerekir)
1. Claude Desktop'ı açın
2. Settings → Connectors → Add Custom Connector
3. Bilgileri girin:
Name: Borsa MCP
URL: https://borsa.surucu.dev/mcp
4. Add butonuna tıklayın
5. Hemen kullanmaya başlayın! 🎉
### Google Antigravity ile Kullanım
1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
2. MCP Servers seçeneğini seçin - MCP Store açılacak
3. Üstteki Manage MCP Servers butonuna tıklayın
4. View raw config seçeneğine tıklayın
5. mcpconfig.json dosyasına aşağıdaki yapılandırmayı ekleyin:
json
"mcpServers": {
"borsa-mcp": {
"serverUrl": "https://borsa.surucu.dev/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
## 🎯 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 (getevdsdata, ücretsiz API key)
🆕 Makro Veriler: TCMB enflasyon verileri ve hesaplama araçları (getmacrodata)
🎯 Pivot Points: 3 direnç & 3 destek seviyesi hesaplama (klasik pivot formülü)
📊 Endeksler: BIST + US endeksleri tek araçla (getindexdata)
💡 Değer Yatırımı: Buffett analizi ve finansal sağlık araçları (ROE, ROIC, Altman Z-Score)
💰 TEFAS Fonları: 836+ fon, performans, portföy, karşılaştırma (comparemode)
₿ Kripto Paralar: BtcTurk + Coinbase birleşik (getcryptomarket)
💱 Döviz & Emtia: 65 para birimi, altın, petrol (borsapy entegrasyonu)
📅 Ekonomik Takvim: TR, US, EU, DE, GB, JP, CN (7 ülke)
☪️ Katılım Finans: Katılım finans uygunluk bilgisi (includeislamic parametresi)
📰 KAP Haberleri: Liste + detay (newsid parametresi ile)