tefas-fund-comparator
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., "@tefas-fund-comparator Compare MAC and AFT mutual funds"
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.
tefas-fund-comparator
MCP (Model Context Protocol) sunucusu: TEFAS fonlarını listeleme, karşılaştırma, getiri/performans analizi ve portföy dağılımı inceleme.
Sunucu adı: tefas-fund-comparator
Özellikler
Tool | Açıklama |
| Fon tipi + tarih aralığı + kod/isim filtresi ile fon listesi |
| Fiyat geçmişi, özet metrikler, portföy dağılımı |
| Çoklu fon: getiri, volatilite, Sharpe, max drawdown, AUM |
| Varlık dağılımı (hisse, repo, eurobond, …) |
| RB / SB / MB bazlı TEFAS getiri tabloları |
| Risk/getiri istatistikleri (pandas) |
stdio + Streamable HTTP transport
pytefas: otomatik chunking + rate-limit retry
tefasfon: RB/SB/MB getiri tabloları
Çıktı: markdown tablo veya JSON
Related MCP server: mftool-mcp
Kurulum
Gereksinimler
Python 3.10+
İnternet erişimi (TEFAS API)
pip
cd TEFAS-MCP
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
# source .venv/bin/activate
pip install -e .
# veya
pip install -r requirements.txt
pip install -e .uv
cd TEFAS-MCP
uv venv
uv pip install -e .Çalıştırma
stdio (Claude Code / Cline / Cursor — varsayılan)
python -m tefas_mcp.server
# veya
tefas-fund-comparatorStreamable HTTP
python -m tefas_mcp.server --transport http --host 127.0.0.1 --port 8000
# Endpoint: http://127.0.0.1:8000/mcp
# Health: http://127.0.0.1:8000/healthYardım
python -m tefas_mcp.server --helpDocker (yerel)
# Image build + run (port 8000)
docker compose up --build
# veya
docker build -t tefas-fund-comparator .
docker run --rm -p 8000:8000 -e PORT=8000 tefas-fund-comparatorKontrol:
curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/Render.com (Docker Web Service)
Hazır dosyalar: Dockerfile, render.yaml, .dockerignore.
A) Blueprint (önerilen)
Kodu GitHub’a push edin.
Render Dashboard → New → Blueprint.
Repo’yu seçin;
render.yamlotomatik okunur.Deploy sonrası URL örneği:
https://tefas-fund-comparator.onrender.comMCP endpoint:
https://tefas-fund-comparator.onrender.com/mcp
Health:https://tefas-fund-comparator.onrender.com/health
B) Manuel Web Service
New → Web Service → repo bağla
Runtime: Docker
Dockerfile path:
./DockerfileHealth Check Path:
/healthEnv (opsiyonel; Dockerfile varsayılanları yeter):
Key | Value |
|
|
|
|
|
|
|
|
PORTRender tarafından otomatik enjekte edilir; elle yazmayın.
Claude / Cline ile Render URL
Claude genelde uzak HTTP MCP’ye doğrudan bağlanmaz; mcp-remote kullanın
(examples/mcp_config.render.json):
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR-SERVICE.onrender.com/mcp"
]
}
}
}YOUR-SERVICE kısmını kendi Render servis adınızla değiştirin.
Render notları
Free plan idle sonrası uykuya geçer; ilk istek ~30–60 sn sürebilir.
TEFAS rate-limit nedeniyle uzun analizler yavaş / timeout olabilir; gerekirse plan yükseltin veya timeout’ları artırın.
Servis herkese açıksa istek koruması (auth, IP allowlist, Cloudflare) eklemeniz önerilir — bu imajda API anahtarı yoktur.
MCP istemci yapılandırması
Aşağıda PYTHON yolunu kendi venv’inize göre düzenleyin.
Claude Code / Claude Desktop (claude_desktop_config.json veya proje .mcp.json)
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "C:\\Users\\kerem\\Documents\\TEFAS-MCP\\.venv\\Scripts\\python.exe",
"args": ["-m", "tefas_mcp.server"],
"cwd": "C:\\Users\\kerem\\Documents\\TEFAS-MCP"
}
}
}macOS/Linux örneği:
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "/path/to/TEFAS-MCP/.venv/bin/python",
"args": ["-m", "tefas_mcp.server"],
"cwd": "/path/to/TEFAS-MCP"
}
}
}Global pip install -e . yaptıysanız:
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "tefas-fund-comparator",
"args": []
}
}
}Cline (VS Code)
Cline → MCP Settings:
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "python",
"args": ["-m", "tefas_mcp.server"],
"cwd": "C:\\Users\\kerem\\Documents\\TEFAS-MCP",
"disabled": false
}
}
}HTTP + mcp-remote (isteğe bağlı)
Önce sunucuyu HTTP modunda başlatın, sonra:
{
"mcpServers": {
"tefas-fund-comparator-http": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:8000/mcp"]
}
}
}uvx (paket yayımlanmışsa)
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "uvx",
"args": ["tefas-fund-comparator"]
}
}
}Yerel dizinden uv run:
{
"mcpServers": {
"tefas-fund-comparator": {
"command": "uv",
"args": ["run", "--directory", "C:\\Users\\kerem\\Documents\\TEFAS-MCP", "python", "-m", "tefas_mcp.server"]
}
}
}Fon tipleri
Kod | Anlam | tefasfon alias |
| Yatırım fonu |
|
| Emeklilik |
|
| Borsa yatırım fonu (ETF) |
|
| Gayrimenkul |
|
| Girişim sermayesi |
|
Örnek tool çağrıları
Agent / istemci üzerinden (anlamsal örnekler):
list_funds(fund_type="YAT", name_contains="ALTIN", limit=20)
get_fund_details(fund_code="AAL", fund_type="YAT")
compare_funds(
fund_codes=["AAL", "AAK"],
start_date="2026-01-01",
end_date="2026-04-01",
metrics=["return", "volatility", "sharpe", "max_drawdown"]
)
get_portfolio_breakdown(fund_code="AAL")
get_historical_returns(fund_type="YAT", basis="RB", limit=25)
analyze_performance(
fund_codes=["AAL", "AAK"],
start_date="2025-04-01",
end_date="2026-04-01",
risk_free_annual=0.40
)Rate limit ve süre
TEFAS yaklaşık dakikada 6 istek sınırına yakındır. pytefas uzun aralıkları ~28 günlük parçalara böler:
Aralık | Kabaca süre |
1 ay | ~10 sn |
3 ay | ~1 dk |
1 yıl | ~3 dk |
Aynı istekler ~60 sn TTL ile bellekte önbelleğe alınır.
Test
pip install -e ".[dev]"
pytest -qAğ gerektiren smoke test (manuel):
python -c "from tefas_mcp.client import get_service; print(get_service().fetch_info('2026-04-20','2026-04-24',kind='YAT',fund_code='AAL').head())"Proje yapısı
src/tefas_mcp/
server.py # FastMCP entrypoint
client/ # pytefas + tefasfon façade
tools/ # 6 MCP tools
analytics/ # Sharpe, vol, max DD
models/ # enums / validation
utils/ # dates, formatters, errorsBağımlılıklar
Uyarı
Bu araç yatırım tavsiyesi değildir. TEFAS API’si resmi olarak dokümante edilmemiştir; site değişikliklerinde paket güncellemesi gerekebilir. Metrikler eğitim / karşılaştırma amaçlı basitleştirilmiş istatistiklerdir.
Lisans
MIT
Available Tools
6 toolsanalyze_performanceA
Analyze risk/return statistics for one or more TEFAS funds.
Computes for each fund (from daily price history):
Cumulative return
Annualized return
Annualized volatility
Sharpe ratio (using
risk_free_annual)Maximum drawdown
Observation count
Latest AUM and investor count when available
Inputs: end_date (required), fund_codes (required), start_date (required), fund_type, +2 more. Returns: result
compare_fundsA
Compare multiple TEFAS funds on return, risk, and size metrics.
Fetches price history for each code and computes selected metrics: cumulative/annualized return, volatility, Sharpe ratio, max drawdown, latest AUM, and investor count.
Inputs: end_date (required), fund_codes (required), start_date (required), metrics, +3 more. Returns: result
get_fund_detailsA
Get general info, optional price history, and portfolio allocation for a fund.
Resolves the fund code (and type if omitted), returns a summary of latest price / AUM / investors, period return, recent price history, and latest asset allocation.
Inputs: fund_code (required), end_date, fund_type, start_date, +4 more. Returns: result
get_historical_returnsA
Fetch TEFAS return tables by ranking basis (RB / SB / MB).
Uses tefasfon to pull TEFAS comparative return data:
RB (return-based): multi-horizon returns (1M/3M/6M/1Y/…) and risk value when dates are omitted; period return when dates are set.
SB (size-based): portfolio size / share count change and net return between two dates (both dates required).
MB (management fee-based): fee vs annual return metrics (both dates required).
Inputs: basis, limit, end_date, fund_type, +4 more. Returns: result
get_portfolio_breakdownA
Get asset allocation (portfolio breakdown) for a TEFAS fund.
Returns holdings percentages such as stocks, reverse repo, eurobonds, government bonds, precious metals, foreign assets, etc. (whatever TEFAS publishes for that fund on the selected date).
Inputs: fund_code (required), min_pct, fund_type, as_of_date, +1 more. Returns: result
list_fundsA
List TEFAS funds by type and optional date range / filters.
Pulls general fund information (code, name, price, AUM, investors) from TEFAS via pytefas. By default returns a snapshot of the latest available day in the range (one row per fund).
Inputs: limit, end_date, fund_type, start_date, +4 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools like analyze_performance and compare_funds compute similar metrics (return, volatility, Sharpe, drawdown, AUM), and get_fund_details overlaps with get_portfolio_breakdown on portfolio allocation. While descriptions help differentiate, the boundaries between these tools are fuzzy, causing potential confusion.
All tool names follow a consistent verb_noun pattern in snake_case: analyze_performance, compare_funds, get_fund_details, get_historical_returns, get_portfolio_breakdown, list_funds. No mixing of styles or irregular patterns.
With 6 tools, the server is well-scoped for the purpose of comparing TEFAS funds. Each tool addresses a distinct aspect (listing, details, performance, comparison, historical returns, portfolio breakdown) without being excessive or thin.
The tool set covers listing, detailed info, performance analysis, comparison, and portfolio breakdown. Minor gaps exist, such as lacking a direct raw price history endpoint (included in get_fund_details) and no filter for top performers, but overall the surface is sufficient for fund comparison.
Maintenance
Related MCP Connectors
Financial data and analysis tools for Turkish BIST and international markets via MCP.
Official MCP server of Hasfiyat Altın API: live Turkish gold & FX prices (TRY), history, calc.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
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
- AlicenseAqualityBmaintenanceMCP Server for publicly available real-time Indian Mutual Funds data128MIT
- AlicenseAqualityCmaintenanceMCP server for live Turkey data — gold & silver prices, official TCMB exchange rates, fuel pump prices, prayer times and the Kandilli earthquake feed.759 npm1MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that reconstructs hedge-fund/superinvestor portfolios from SEC EDGAR 13F filings, offering tools to query fund holdings, consensus activity, and quarter-over-quarter changes through a read-only API.4AGPL 3.0