fonlar-mcp
Provides tools to query Turkish investment fund data (prices, performance, portfolio, search, comparison) from the TEFAS public API, usable within Windsurf (by Codeium).
Provides tools to query Turkish investment fund data (prices, performance, portfolio, search, comparison) from the TEFAS public API, usable within Antigravity (by Google).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fonlar-mcp AAK fonunun son fiyatı ve getirisi"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fonlar-mcp
Türkiye'deki yatırım fonlarının (TEFAS) verilerini Claude'a sunan Model Context Protocol sunucusu.
Claude Desktop veya Claude Code üzerinden doğrudan TEFAS'a sorgu atmanı sağlar:
"AAK fonunun son fiyatı ve 1 yıllık getirisi nedir?"
"GO9 ve TTE fonlarını portföy ve performans olarak karşılaştır."
"İçinde 'altın' geçen fonları listele."
Özellikler
Kimlik bilgisi gerektirmez — TEFAS'ın public API'sini kullanır.
Stdio transport — yerel makinede çalışır, dışarı port açmaz.
Rate-limit dostu — TEFAS'ın 6 req/dk sınırına otomatik saygı.
6 araç + 2 kaynak + 1 hazır prompt sunar.
Related MCP server: finhay-mcp-server
Araçlar (Tools)
Tool | Açıklama |
| Güncel fiyat, günlük getiri, portföy büyüklüğü |
| Hafta / 1ay / 3ay / 6ay / 1yıl / 3yıl / 5yıl geçmiş |
| Kategori bazlı portföy dağılımı |
| İki fonun getiri ve portföy karşılaştırması |
| Fon kodu / ünvan araması |
| 1a/3a/6a/yb/1y/3y/5y getiri tablosu |
Kurulum
1. Bağımlılıkları kur
git clone https://github.com/maku-cpu/fonlar-mcp.git
cd fonlar-mcp
uv syncuv yüklü değilse: https://docs.astral.sh/uv/getting-started/installation/
2. Claude Desktop'a ekle
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya
%APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"fonlar": {
"command": "uv",
"args": [
"--directory", "/MUTLAK/PATH/fonlar-mcp",
"run", "fonlar-mcp"
]
}
}
}Claude Desktop'u kapat-aç. Sağ alttaki bağlantı ikonunda fonlar görünmeli.
3. Claude Code'a ekle
claude mcp add fonlar -- uv --directory /MUTLAK/PATH/fonlar-mcp run fonlar-mcpveya proje kökünde .mcp.json:
{
"mcpServers": {
"fonlar": {
"command": "uv",
"args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
}
}
}Diğer MCP Client'larla Kullanım
MCP standart bir protokol — Claude'a özel değil. fonlar-mcp aşağıdaki tüm
client'larla aynı server kodu ile çalışır, sadece config dosyasının
yeri/formatı değişir.
Cursor
~/.cursor/mcp.json veya proje kökünde .cursor/mcp.json:
{
"mcpServers": {
"fonlar": {
"command": "uv",
"args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"fonlar": {
"command": "uv",
"args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
}
}
}Antigravity (Google)
Settings → MCP Servers, veya ~/.antigravity/mcp_settings.json:
{
"mcpServers": {
"fonlar": {
"command": "uv",
"args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
}
}
}Zed
~/.config/zed/settings.json içinde context_servers bloğu:
{
"context_servers": {
"fonlar": {
"command": {
"path": "uv",
"args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
}
}
}
}
uvyoksa alternatif olarak doğrudan Python kullanılabilir:"command": "python3", "args": ["-m", "fonlar_mcp.server"], "env": {"PYTHONPATH": "/MUTLAK/PATH/fonlar-mcp/src"}
Test
MCP Inspector ile araçları manuel deneyebilirsin:
cd fonlar-mcp
npx @modelcontextprotocol/inspector uv run fonlar-mcpTarayıcıda açılan UI'dan tool'ları çağır, JSON çıktıyı gör.
Periyod Kodları
get_fon_fiyat_gecmisi ve karsilastir_fonlar aşağıdaki periyodları kabul eder:
hafta · 1ay · 3ay · 6ay · 1yil · 3yil · 5yil
Önemli Uyarı
Bu araç bilgilendirme amaçlıdır. TEFAS verilerini doğrudan iletir, yatırım tavsiyesi değildir. Yatırım kararlarınız size aittir.
Lisans
MIT — bkz. LICENSE.
Veri Kaynağı
Tüm veriler tefas.gov.tr public API'sinden alınır.
Available Tools
6 toolsara_fonA
Fon kodu veya ünvanına göre TEFAS'ta fon arar / listeler.
Bu tool fon listeleme, filtreleme ve keşif için ana giriş noktasıdır. Kullanım örnekleri:
"Altın fonlarını listele" → ara_fon("altın")
"AK Portföy'ün tüm fonları" → ara_fon("AK PORTFÖY")
"Hangi BIST 30 fonları var?" → ara_fon("BIST 30")
"Teknoloji fonları neler?" → ara_fon("teknoloji")
Çoklu adımlı sorularda (örn: "altın fonlarının en getirili olanı") İLK ADIM olarak bu tool'u çağır, sonra dönen kodları diğer tool'lara (donemsel_getiri_ozeti, get_fon_portfoy vb.) besle.
Args: metin: Aranacak kelime/fon kodu (örn: "altın", "AK PORTFÖY", "TTE"). limit: Dönecek maksimum sonuç sayısı (default 20).
Inputs: metin (required), limit.
donemsel_getiri_ozetiB
Bir fonun standart dönemsel getirilerini (1a, 3a, 6a, yb, 1y, 3y, 5y) döner.
Args: fon_kodu: TEFAS fon kodu.
Inputs: fon_kodu (required).
get_fon_fiyatA
Bir fonun güncel fiyat ve günlük getiri bilgisini döner.
Args: fon_kodu: 3 karakterli TEFAS fon kodu (örn: "AAK", "GO9", "TTE").
Inputs: fon_kodu (required).
get_fon_fiyat_gecmisiB
Fonun günlük fiyat geçmişini döner.
Args: fon_kodu: TEFAS fon kodu. periyod: "hafta" | "1ay" | "3ay" | "6ay" | "1yil" | "3yil" | "5yil"
Inputs: fon_kodu (required), periyod.
get_fon_portfoyA
Bir fonun portföy dağılımını döner (kategori bazlı yüzdeler).
Args: fon_kodu: TEFAS fon kodu. tarih: YYYYMMDD formatında. Boş ise son iş günü kullanılır.
Inputs: fon_kodu (required), tarih.
karsilastir_fonlarA
İki fonun fiyat performansını ve portföy dağılımlarını karşılaştırır.
Args: fon_1: Birinci fon kodu. fon_2: İkinci fon kodu. periyod: Getiri karşılaştırması için periyod (hafta..5yil).
Inputs: fon_1 (required), fon_2 (required), periyod.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct operation: searching funds, getting period returns, current price, historical prices, portfolio distribution, and comparing two funds. There is no overlap in purpose.
Most tools follow a verb_noun pattern in Turkish (ara_fon, get_fon_fiyat, get_fon_fiyat_gecmisi, get_fon_portfoy, karsilastir_fonlar), but donemsel_getiri_ozeti uses a different structure (adjective_noun_noun), creating a minor inconsistency.
With 6 tools, the set is well-scoped for a mutual fund information server. Each tool provides necessary functionality without unnecessary bloat or missing critical operations for common queries.
The tool set covers core fund operations: search, period returns, current and historical prices, portfolio composition, and comparison. Minor gaps include the inability to list all funds without a search term and lack of detailed fund metadata (e.g., management fees, fund manager).
Maintenance
Related MCP Connectors
Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.
Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what's on your morning desk, rank a watchlist by ROE, log a trade or save a thesis. OAuth sign-in. Free to start.
Connect your portfolio to Claude, ChatGPT, or Codex to analyze it and make smarter investments.
Ask Claude about your Google Ads: campaign performance, wasted search terms, GAQL reports.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables Claude Desktop to access investment fund data in Turkey through the FonParam API, allowing users to list, compare, and analyze funds, view company statistics, and get inflation data.1545 npm3MIT

finhay-mcp-serverofficial
AlicenseNot gradedqualityFmaintenanceEnables querying real-time stock prices, gold, crypto, interest rates, portfolio data, and financial analysis from Finhay Securities via Claude AI.79 npmMIT- FlicenseBqualityDmaintenanceEnables natural language interaction with Toss Securities Open API for stock quotes, account management, and order placement via Claude.28-
- AlicenseBqualityBmaintenanceEnables AI assistants to retrieve live BIST and global stock prices, cryptocurrency prices, exchange rates, currency conversion, and inflation data from free public sources without API keys.51MIT