finance-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_exchange_rateA | İki para birimi arasındaki güncel (veya belirli bir tarihteki) döviz kurunu döndürür (örn. USD → TRY). |
| convert_currencyA | Bir miktarı bir para biriminden diğerine, güncel kur üzerinden çevirir. |
| get_historical_rateA | Belirtilen bir tarihteki döviz kurunu döndürür. Geçmiş ECB/Frankfurter verilerine (1999'dan itibaren) erişim sağlar. |
| get_tcmb_rateA | TCMB (Türkiye Cumhuriyet Merkez Bankası) resmi günlük kur bülteninden, belirtilen dövizin alış ve satış kurlarını TRY cinsinden döndürür. Frankfurter'dan farklı olarak resmi alış/satış ayrımı içerir. |
| get_crypto_priceA | Bir kripto paranın belirtilen para birimi cinsinden güncel fiyatını, 24 saatlik değişimini ve piyasa değerini döndürür (örn. bitcoin → try). |
| get_multi_crypto_priceA | Birden fazla kripto paranın fiyatını tek sorguda döndürür. Ör: bitcoin, ethereum ve solana'nın TRY cinsinden fiyatlarını aynı anda alabilirsiniz. |
| get_bist_priceA | Borsa İstanbul (BIST) hisse senedinin güncel fiyatını, değişimini ve piyasa verilerini döndürür. Veri Yahoo Finance üzerinden 15 dakika gecikmeli olarak sağlanır. Sembol olarak sadece hisse kodunu girin (ör. THYAO, GARAN, ASELS). |
| get_global_stock_priceA | Dünya genelindeki tüm hisse senetlerinin, borsa endekslerinin (S&P 500, NASDAQ vb.) ve ETF'lerin anlık/güncel fiyat ve piyasa verilerini döndürür. (Örn: AAPL, NVDA, TSLA, MSFT, AMZN, SAP.DE, SHEL.L, ^GSPC, ^IXIC). |
| get_inflation_dataA | Türkiye TÜFE (Tüketici Fiyat Endeksi) enflasyon verisini döndürür. Kaynak: Dünya Bankası (TÜİK kaynaklı yıllık TÜFE değişim %, FP.CPI.TOTL.ZG). Yıllık ortalama seridir. |
| get_stock_historyB | Bir hisse senedinin (BIST veya küresel) geçmiş açılış/en yüksek/en düşük/kapanış (OHLC) ve hacim verisini döndürür. Teknik analiz ve grafik çizimi için kullanılır. Örn: THYAO.IS, AAPL, NVDA, ASELS.IS |
| get_crypto_historyB | Bir kripto paranın geçmiş fiyat (OHLC) verisini döndürür. USD veya TRY cinsinden grafik/teknik analiz için uygundur. Örn: bitcoin, ethereum, solana, BNB, XRP. |
| get_commodity_priceC | Emtia fiyatlarını döndürür: altın, gümüş, petrol (WTI/Brent), doğalgaz, bakır, platin, paladyum gibi. Türkçe adlarla veya doğrudan sembolle sorgulanabilir. |
| search_symbolA | Borsada işlem gören bir varlığı sembolüne veya adına göre arayarak doğru ticker'ı bulmanıza yarar. BIST hisseleri, küresel hisseler, ETF'ler ve endeksler için uygundur. Örn: 'ASELSAN' → ASELS.IS, 'Tesla' → TSLA, 'BIST Banka' → XBANK.IS. |
| get_bist_indicesA | Borsa İstanbul (BIST) endekslerinin güncel değerini, değişimini ve işlem hacmini döndürür. Varsayılan: XU100, XU030, XU050, XU015, XBANK, XUSIN. |
| get_macro_indicatorsA | Bir ülkenin temel makroekonomik göstergelerini döndürür (varsayılan: Türkiye): GSYİH büyümesi, kişi başına GSYİH, enflasyon, işsizlik, cari işlemler, rezervler, ihracat/ithalat. Dünya Bankası + FRED kaynaklı. |
| get_policy_rateC | TCMB politika faizini (1 hafta vadeli repo) ve geçmiş faiz değişikliklerini döndürür. Kaynak: TCMB resmi web sitesi faiz oranları tablosu. |
| get_gov_bond_yieldsA | Türkiye 10 yıllık devlet tahvili faizini ve gösterge (referans/2 yıllık) tahvil faizini döndürür. Kaynak: doviz.com tahvil bülteni. |
| get_fundamentalsB | Bir hisse senedinin temel (fundamental) analiz göstergelerini döndürür: F/K oranı, EPS, PD/DD, temettü verimi, marjlar, büyüme oranları, beta, şirket profili, analist hedefleri. BIST ve küresel hisseler desteklenir. |
| get_correlationA | İki varlığın (hisse, endeks, kripto veya para birimi) fiyat korelasyonunu ve getiri istatistiklerini hesaplar. Portföy çeşitlendirme / bağımlılık analizi için kullanılır. Örn: (THYAO.IS, BIST100) veya (BTC-USD, XU100.IS). |
| analyze_portfolioB | Bir portföyün değerini, sektör/para birimi dağılımını, getirisini, riskini (volatilite), Sharp oranını ve günlük değişimini analiz eder. Pozisyon listesine hisse/endeks/ETF/kripto girebilirsiniz. |
| get_fund_priceB | TEFAS'ta işlem gören bir yatırım fonunun (YAT/EMK...) güncel fiyatını (NAV) ve son dönem getirisini döndürür. Örn: GAF (Girişim), ABA (Aksiyo), fon kodu veya fon adı girilebilir. |
| get_viop_quoteC | Vadeli İşlem ve Opsiyon Piyasası (VİOP) kontratlarının fiyat, değişim, alış/satış ve hacim bilgilerini döndürür. Belirli bir kontrat parsent verisi için ş/kod filtresi uygulanabilir. Örn: 'F_X10XB1026' veya 'X10'. |
| get_market_summaryB | Borsa İstanbul piyasa özeti: XU100/XU030/XU050 ana endekslerinin ve önemli hisselerin (banka, sanayi) anlık fiyat ve değişim bilgileri. |
| get_economic_calendarB | Küresel ekonomik takvim: merkez bankası faiz kararları, TÜFE, GSYİH, istihdam gibi makro verilerin resmi açıklanma takvimini döndürür. Ülke ve etki düzeyine göre filtrelenebilir. |
| get_financial_newsA | Bir hisse, endeks, kripto veya para birimi hakkındaki güncel finans haberlerini döndürür. Kaynak: Yahoo Finance RSS. Örn: XU100.IS (TR), THYAO.IS, AAPL, BTC-USD, USDTRY=X. |
| get_technical_indicatorsA | Bir hissenin OHLC geçmişi üzerinden teknik indikatörleri hesaplar: RSI(14), SMA(20/50/200), EMA(12/26), MACD(12/26/9), Bollinger bantları(20,2σ) ve ATR(14). Son N mumda indikatör değerleri + güncel sinyal yorumu döner. Örn: THYAO.IS, AAPL, BTC-USD. |
| get_market_moversB | Yahoo Finance tarayıcısıyla hazır hisse listelerini döndürür: günün en çok yükselenleri/düşenleri, en aktifler, teknoloji büyüme, değer hisseleri vb. Piyasa taraması ve fırsat keşfi için kullanılır. |
| get_trending_stocksA | Belirli bir bölgede en çok trend olan / ilgi gören hisseleri fiyat ve değişim bilgisiyle döndürür. Örn: TR bölgesi için BIST hisseleri. |
| get_market_indicatorsA | Makro piyasa göstergelerini tek çağrıda döndürür: VIX (korku endeksi), ABD 13 hafta/5/10/30 yıl tahvil faizleri ve Dolar Endeksi (DXY). Piyasa risk iştahı ve getiri eğrisi analizi için. |
| get_altin_gram_priceB | Altın fiyatını uluslararası ons (USD) ve gram (TRY) karşılığıyla döndürür. 24 ayar ve 22 ayar (ziynet) gram fiyatı hesaplanır. Kaynak: Yahoo Finance (altın vadeli işlem + USD/TRY). |
| get_tcmb_snapshotA | Türkiye ekonomik göstergelerinin anlık özetini döndürür: ana döviz kurları (USD/TRY, EUR/TRY, GBP/TRY, CHF/TRY, EUR/USD), TCMB politika faizi, ABD 10 yıl tahvil faizi ve gram altın fiyatı. Hızlı 'Türkiye nasıl gidiyor' özeti için. |
| backtest_portfolioA | Verilen portföy (sembol + adet) için geçmiş performans analizi yapar: toplam getiri, yıllıklanmış getiri (CAGR), volatilite, maksimum düşüş (drawdown), Sharpe oranı ve varlık bazlı katkılar. TRY varlıklar portföye girmeden önce USD'ye çevrilir; kur etkisi ayrıca gösterilir. Örn: [{symbol:'THYAO.IS',quantity:100},{symbol:'AAPL',quantity:20}] |
| get_crypto_fear_greedA | Kripto Korku ve Açgözlülük Endeksi (0-100) güncel değerini ve son 30 günlük geçmişini döndürür. 0=aşırı korku, 100=aşırı açgözlülük. Piyasa duygu analizi ve zamanlama için. |
| get_dividend_historyA | Bir hissenin temettü (kâr payı) geçmişini, yıllık toplamlarını ve son 12 aylık temettü verimini döndürür. BIST dahil tüm borsaları destekler. Örn: THYAO.IS, GARAN.IS, AAPL, KO. |
| get_earnings_infoA | Bir hissenin yaklaşan bilanço (kazanç) tarihini ve analist beklentilerini döndürür: tahmini EPS aralığı, tahmini ciro, son bilanço tarihi ve beklentiye göre EPS büyümesi. BIST ve ABD hisseleri için çalışır. |
| get_analyst_consensusB | Bir hisse için analist konsensüsünü döndürür: güçlü alış/alış/tut/satış sayıları, yükseliş yüzdesi, son 6 dönemin değişimi ve ortalama hedef fiyat. BIST hisselerinde de Türkçe aracı kurumlar tarafından verilen veriler yer alır. |
| get_crypto_market_overviewB | Kripto para piyasasının genel görünümünü döndürür: toplam piyasa kapitalizasyonu, 24 saatlik hacim ve değişim, Bitcoin/Ethereum dominansı ve en çok aranan kripto paralar. CoinGecko (ücretsiz, API key yok). |
| get_data_healthA | Tüm veri kaynaklarının (Yahoo Finance, TCMB, CoinGecko, TEFAS, Frankfurter, ForexFactory, Dünya Bankası, alternative.me vb.) anlık erişilebilirliğini, yanıt süresini ve önbellek durumunu raporlar. Hangi kaynağın çalışıp çalışmadığını teşhis etmek için kullanılır. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| araç-kataloğu | Sunucudaki araçların ne yaptığının özeti ve örnek kullanıcı soruları. Doğru aracı seçmek için okunabilir. |
TDQS
Scored across 38 tools
Most tools have clearly distinct purposes (e.g., get_crypto_price vs get_stock_history vs get_exchange_rate). However, several market summary tools (get_market_summary, get_bist_indices, get_market_indicators, get_tcmb_snapshot) overlap in scope, which could cause confusion. Descriptions help but boundaries are not always crisp.
Almost all tools follow a consistent verb_noun pattern in snake_case (get_*, analyze_*, backtest_*, convert_*, search_*). The few deviations like get_altin_gram_price (Turkish word) still fit the pattern. No mixed camelCase or vague naming.
With 38 tools, the server is very heavy. While finance is broad, many tools are fine-grained variations (e.g., multiple crypto price tools, multiple exchange rate tools, multiple market snapshot tools). This increases cognitive load and the risk of misselection.
The server covers a wide range of financial data: stocks, crypto, forex, commodities, macro, bonds, funds, technical indicators, news, and portfolio analysis. Minor gaps exist (e.g., historical commodity data, ETF history, detailed fund analytics), but core workflows are well supported.