Borsa MCP nedir? BIST ve TEFAS verisini asistana bağlamak, kurulum ve sınırlar

Asistanına bir hissenin, fonun ya da döviz kurunun verisini sorarsın; Borsa MCP Borsa İstanbul ve ABD hisseleri, TEFAS fonları, kripto, döviz ve TCMB verilerini getirir. 23 aracın hepsi kodda "yalnız okuma" olarak işaretli; emir verme ya da hesap işlemi aracı yok. Tek bir geliştiricinin (saidsurucu) açık kaynak topluluk projesi; kurulumsuz uzak adresle (Claude Desktop'ta ücretli Claude aboneliği gerekir) ya da yerel uvx kurulumuyla kullanılır, MIT lisanslı ve ücretsiz. README'nin kendi uyarısı: yatırım tavsiyesi değildir, yapay zekâ halüsinasyon yapabilir, verileri doğrula. Veri gecikmesi ve veri kaynaklarının lisansı belgede yok.

Ne yapar: Asistana borsa, fon, döviz ve TCMB verisi okutur
Tür: MCP sunucusu (topluluk projesi; uzak ya da yerel)
Nerede: Claude Desktop, Google Antigravity, 5ire
Alım-satım: Yok; 23 aracın hepsi yalnız okuma
Veri: Gecikme ve lisans belgede yok
Türkçe: Arayüz ve belge Türkçe; yanıt dili asistana bağlı
Ücret: Ücretsiz (MIT); Claude Desktop uzak bağlayıcı ücretli abonelik ister

Borsa MCP ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Borsa MCP ile asistanına "THYAO'nun finansal tablolarını getir" ya da "şu fonları karşılaştır" diyebilirsin; asistan sunucudaki araçları çağırıp veriyi çeker ve yorumlar. README'ye göre kapsam: BIST ve ABD hisseleri (fiyat geçmişi, şirket profili, finansal tablolar, teknik göstergeler), KAP/Mynet haberleri, TEFAS fonları, kripto (BtcTurk, Coinbase), döviz ve emtia, TCMB enflasyon ve EVDS serileri.

SenHisseyi, fonu ya da kuru sorarsın

AsistanClaude Desktop, Google Antigravity, 5ire

Borsa MCPUzak adres ya da yerel uvx

Piyasa verisiBIST, ABD hisseleri, TEFAS, kripto, döviz, TCMB

23 aracın hepsi yalnız okuma; emir verme yok.

Hisse verisini asistana sordurmakNe alırsın: Metin yanıt; asistan araç sonuçlarını yorumlarAyrı kurulum gerekir

Yetkinlik sınırı da net: kodda 23 aracın hepsi readOnlyHint ile okuma amaçlı işaretli (kaynak koda göre); alım-satım emri, hesap açma ya da para transferi aracı yok. Araç sayısı kaynaklarda tutarsız (kod 23, README 26 ve başka yerde 28), kod esas alındı.

Kime yarar: Türkiye piyasası verisini asistanla hızlı sorgulamak ve derlemek isteyenlere. Bu bir yatırım tavsiyesi aracı değildir; sayfamız da yatırım tavsiyesi değildir.

Borsa MCP nasıl kurulur?

İki yol var: kurulumsuz uzak adres (https://borsa.surucu.dev/mcp) ya da bilgisayarında çalışan yerel kurulum. Adım ve komutlar README'den aynen alındı. README'de Claude Code, Cursor, VS Code ve ChatGPT için kurulum adımı yok.

Claude Desktop'ı aç. README bu yol için ücretli Claude aboneliği gerektiğini yazıyor.
Settings sonra Connectors sonra Add Custom Connector yolunu aç.
Ad olarak Borsa MCP, adres olarak https://borsa.surucu.dev/mcp yaz ve ekle.

Önkoşullar (README): Python 3.11+, Git, uv. Windows'ta Microsoft Visual C++ Redistributable da gerekir. Settings sonra Developer sonra Edit Config ile claude_desktop_config.json dosyasını aç ve mcpServers altına şunu ekle, sonra Claude Desktop'ı kapatıp yeniden aç:

claude_desktop_config.json

› {"mcpServers": {"Borsa MCP": {"command": "uvx", "args": ["--from", "git+https://github.com/saidsurucu/borsa-mcp", "borsa-mcp"]}}}

Bu yöntem kodu GitHub'ın ana dalından çeker; hangi sürümü çalıştırdığını sabitlemez. Kurmadan önce depoyu gözden geçir.

Agent oturumunda editörün yan panelindeki "…" menüsünden MCP Servers › Manage MCP Servers › View raw config yolunu aç ve mcp_config.json dosyasına şunu ekle:

mcp_config.json

› {"mcpServers": {"borsa-mcp": {"serverUrl": "https://borsa.surucu.dev/mcp", "headers": {"Content-Type": "application/json"}}}}

Tools › +Local yolunda Tool Key olarak borsamcp, ad olarak Borsa MCP yaz; komut alanına aşağıdakini gir, kaydet ve araçtan etkinleştir.

Command› uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp

TCMB EVDS serilerini çekmek için ücretsiz bir EVDS API anahtarı gerekir: evds3.tcmb.gov.tr adresinde kayıt ol, profilinden API Key'i kopyala ve EVDS_API_KEY ortam değişkenine yaz ya da MCP yapılandırmasındaki env bloğuna ekle. EVDS katalog gezintisi ve arama anahtarsız çalışır.

Eski adres borsamcp.fastmcp.app artık veri vermiyor, yalnız taşınma bilgisi döndürüyor. Yeni adres borsa.surucu.dev.

Borsa MCP nasıl kullanılır?

Kurduktan sonra Borsa MCP'yi sohbette an ve ne istediğini normal cümleyle yaz. Veri bir araç çağrısından geliyor; asistanın yorumu ise model çıktısıdır ve yanlış olabilir.

Hisse verisi"Borsa MCP ile THYAO'nun son bir yıllık fiyat geçmişini ve son bilançosundaki net kâr satırını getir. Veriyi olduğu gibi yaz, yorum ekleme."

Fon karşılaştırma"Borsa MCP ile adında "para piyasası" geçen TEFAS fonlarını listele ve son bir yıllık getirilerini yan yana tablo yap."

Kaynağı sor"Az önce verdiğin rakamların hangi araçtan ve hangi kaynaktan geldiğini yaz; emin olmadığın bir şey varsa belirt."

Bu sayfa yatırım tavsiyesi değildir. README: "Yatırım tavsiyesi değildir", "Eğitim amaçlıdır, sorumluluk size aittir" ve yapay zekâ halüsinasyon yapabilir, verileri doğrulayın. Karar vermeden önce rakamları kurumun kendi ekranından doğrula.

Borsa MCP hangi programlarda çalışır?

Claude Desktop (uzak)Var	README bu yol için ücretli abonelik gerektiğini yazıyor.
Claude Desktop (yerel)Var	uvx ile; Python 3.11+, Git ve uv gerekir.
Google Antigravity, 5ireVar	README'de ayrı adım var.
Claude Code, Cursor, VS Code, ChatGPTNet değil	README'de adları geçmiyor. Sunucu standart MCP; "belgede yok" demek "çalışmaz" demek değildir.

Borsa MCP neye erişir, veri nereden gelir?

Ne yapar

Yalnız halka açık piyasa verisini okur. 23 aracın hepsi okuma amaçlı işaretli; emir verme, hesap açma ya da para transferi aracı yok.

Veri kaynakları

README: KAP, Yahoo Finance, BtcTurk, Coinbase, TCMB, TEFAS, Mynet Finans, doviz.com ve borsapy kütüphanesi. Bir kısmı resmî API değil, ara katman ya da kazıma (README TCMB için "web scraping" diyor).

Uzak adres

Uzak adresi kullanırsan sorguların borsa.surucu.dev sunucusundan geçer; README sunucunun gizlilik ya da kayıt politikasını yazmıyor. Kişisel portföy bilgini sorgu metnine yazarsan o metin asistanın ve (uzak ise) sunucunun görebileceği içerik olur.

Yerel kurulum

Python süreci bilgisayarında çalışır ve kaynaklara çıkış yapar. Kodu GitHub ana dalından çektiği için çalıştırmadan önce incelemek sana kalır.

Veri gecikmesi: README bazı bölümlerde "gerçek zamanlı" diyor ama borsa veri gecikmesini ya da veri lisansını belirtmiyor; kripto ve döviz için 1-5 dakikalık önbellek yazıyor. Bu sunucu tek bir geliştiricinin projesi; resmî bir kurum ya da aracı kurum ürünü değil.

GitHub Security Advisories taramasında yayımlanmış uyarı çıkmadı ve OSV'de bu adla PyPI kaydı yok. 21.09.2026'da kapatılan bir SSRF kaydı (issue #20, haber kimliği parametresi) var; düzeltme birleştirilmiş. Bu "güvenli" demek değildir; depoda SECURITY.md da yok.

Borsa MCP ücretsiz mi?

Yazılım ücretsiz ve MIT lisanslı; README'de ücret ya da plan geçmiyor. İki not: Claude Desktop'a uzak bağlayıcı eklemek için README ücretli bir Claude aboneliği gerektiğini yazıyor (o aboneliğin kendi fiyatı ayrı). EVDS anahtarı ücretsiz.

Yapabilirsin

MIT: kodu kullanmak, değiştirmek, dağıtmak serbest

Yasak

Veri kaynaklarının (Yahoo Finance, KAP, TEFAS, BtcTurk, Coinbase, doviz.com, Mynet) kendi kullanım koşulları README'de yazmıyor; kodun MIT olması verinin serbest olduğu anlamına gelmez

Kaynak: README ve LICENSE. Ticari kullanım ya da veriyi yeniden dağıtma için veri kaynaklarının koşullarını kendin kontrol et. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Kullanıcıların bildirdiği Haber aracı THYAO ve GARAN için başarılı görünüp boş liste döndürüyor	Açık issue #22 (03.10.2026); resmî çözüm yok. Haberi kurumun kendi kaynağından kontrol et.
Kullanıcıların bildirdiği Tireli unvanlı şirketler (Tüpraş, Coca-Cola İçecek) ad ile aranınca sonuç çıkmıyor	Açık issue #23; issue'da hisse koduyla arama çalışan örnek olarak geçiyor (TUPRS gibi).
Eski adres borsamcp.fastmcp.app veri vermiyor	README: yeni adres https://borsa.surucu.dev/mcp.
Windows'ta yerel kurulumda paket hatası	README: Microsoft Visual C++ Redistributable kur.

Borsa MCP nasıl kaldırılır?

Uzak bağlantı: Claude Desktop'ta eklenen özel bağlayıcıyı kaldır.
Yerel kurulum: claude_desktop_config.json ya da 5ire Tools listesinden Borsa MCP girdisini sil.

README kaldırma adımı ya da uvx önbelleğini temizleme komutu vermiyor.

Sık sorulan sorular

Borsa MCP nedir?

Tek bir geliştiricinin açık kaynak topluluk projesi: BIST ve ABD hisseleri, TEFAS fonları, kripto, döviz ve TCMB verilerini yapay zekâ asistanına okuma amaçlı açan bir MCP sunucusu.

Borsa MCP yatırım tavsiyesi verir mi?

Hayır. README açıkça yatırım tavsiyesi olmadığını, eğitim amaçlı olduğunu ve yapay zekânın halüsinasyon yapabileceğini yazıyor. Bu sayfa da yatırım tavsiyesi değildir.

Borsa MCP ile alım-satım yapılabilir mi?

Hayır. Sunucudaki 23 aracın hepsi kodda yalnız okuma olarak işaretli; emir verme ya da hesap aracı yok.

Hesap ya da API anahtarı gerekir mi?

Genel kullanımda hayır. Yalnız TCMB EVDS'den seri verisi çekmek için ücretsiz bir EVDS anahtarı gerekir. Claude Desktop'a uzak bağlayıcı eklemek için ise ücretli Claude aboneliği gerekir.

Veriler gerçek zamanlı mı, nereden geliyor?

README bazı bölümlerde gerçek zamanlı diyor ama borsa veri gecikmesini ve veri lisansını belirtmiyor. Kaynaklar KAP, Yahoo Finance, TEFAS, BtcTurk, Coinbase, TCMB, Mynet ve doviz.com; bir kısmı resmî API değil. Karar vermeden önce rakamı kurumun ekranından doğrula.

Uzak sunucu ile yerel kurulum arasındaki fark ne?

Uzak adres kurulum istemez ama sorguların o sunucudan geçmesi demektir; README gizlilik politikası yazmıyor. Yerel kurulum bilgisayarında çalışır ama Python, uv ve Git ister.

İlgili rehberler

Google Antigravity

Yargı PRO efatura-kontrol e-Fatura MCP İhale MCP iyzico MCP (qwertyvan)

Kaynaklar

Resmî kaynaklarda net olmayanlar: Veri gecikmesi ve veri kaynaklarının ticari kullanım koşulları · uzak sunucunun gizlilik politikası · ekip hesabında yönetici izni · Claude Code, Cursor ve ChatGPT'de çalıştığı (README'de adım yok) · TEFAS verisinin resmî API olduğu (yalnız README'nin ifadesi). Her biri ilgili bölümde yazılı.