FonParam MCP
This MCP server enables Claude Desktop to access and analyze comprehensive Turkish investment fund data from the FonParam API, providing tools for fund management and market insights.
Access and filter investment funds by criteria like fund code, type, risk level, TEFAS status, and management company
Compare 2-5 funds side-by-side for performance analysis
Perform investment analysis with customizable parameters including initial investment, monthly contributions, and time periods
Retrieve historical fund data with daily, weekly, or monthly intervals over specified date ranges
Access portfolio management company information including details and their associated funds
Get market statistics including daily data and specific date queries
Explore fund types with filtering capabilities and detailed information
Monitor Turkey inflation data including current rates, historical data, and specific month/year queries
Identify top-performing funds with optional reference fund comparisons
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., "@FonParam MCP show me the top 5 performing funds this month"
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.
📊 FonParam MCP Sunucusu
Bu Model Context Protocol (MCP) sunucusu, Claude Desktop'un Türkiye'deki yatırım fonları verilerine erişmesini sağlar. FonParam API üzerinden fonların güncel verilerini, performans istatistiklerini ve karşılaştırmalarını alabilirsiniz.
✨ Özellikler
📈 Fon Listeleme: Tüm yatırım fonlarını filtreleme ve arama
🔍 Fon Karşılaştırma: 2-5 fonu karşılaştırarak analiz etme
📊 Performans Analizi: Fon yatırım analizi ve getiri hesaplaması
🏢 Şirket Bilgileri: Portföy yönetim şirketleri ve istatistikleri
📈 Geçmiş Veriler: Fonların tarihsel performans verileri
📊 İstatistikler: Günlük piyasa istatistikleri
💰 Enflasyon Verileri: Türkiye enflasyon oranları
Related MCP server: Financial Modeling Prep MCP Server
🚀 Kurulum
Seçenek 1: NPM ile Kurulum (Önerilen)
NPM paketi otomatik olarak çalıştırılacağı için ayrı kurulum gerekmez. Claude Desktop konfigürasyonunda npx kullanarak paketi çalıştırabilirsiniz.
Seçenek 2: Kaynak Koddan Kurulum
1. Bağımlılıkları Yükleyin
npm install2. Projeyi Derleyin
npm run buildClaude Desktop Konfigürasyonu
Claude Desktop'ın claude_desktop_config.json dosyasına aşağıdaki konfigürasyonu ekleyin:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.jsonKonfigürasyon:
NPM paketi kullanıyorsanız (önerilen):
{
"mcpServers": {
"fonparam": {
"command": "npx",
"args": ["-y", "fonparam-mcp"],
"env": {}
}
}
}Kaynak koddan kurulum yaptıysanız:
{
"mcpServers": {
"fonparam": {
"command": "node",
"args": ["/tam/yol/to/fonparam-mcp/dist/index.js"],
"env": {}
}
}
}Not: Kaynak koddan kurulum için
/tam/yol/to/fonparam-mcpkısmını projenizin gerçek yolu ile değiştirin.
4. Claude Desktop'ı Yeniden Başlatın
Konfigürasyonu ekledikten sonra Claude Desktop'ı kapatıp yeniden açın.
🛠️ Kullanılabilir Araçlar
📊 Fon Araçları
list_funds: Fonları listeler ve filtrelertop_performing_funds: En iyi performans gösteren fonları getirircompare_funds: Fonları karşılaştırır (2-5 fon)analyze_fund: Fon yatırım analizi yaparfund_historical_data: Fonun geçmiş değerlerini getirir
🏢 Şirket Araçları
list_companies: Portföy yönetim şirketlerini listelercompany_details: Şirket detaylarını getirir
📈 İstatistik Araçları
statistics: Günlük istatistikleri listelerlatest_statistics: En son istatistikleri getirirstatistics_by_date: Belirli tarihteki istatistikleri getirir
🎯 Fon Tipi Araçları
list_fund_types: Fon tiplerini listelerfund_type_details: Fon tipi detaylarını getirir
💰 Enflasyon Araçları
inflation_rates: Enflasyon verilerini listelerlatest_inflation_rate: En son enflasyon verisini getirirmonthly_inflation_rate: Belirli ay/yıl enflasyon verisini getirir
💡 Kullanım Örnekleri
Claude Desktop'ta Örnek Komutlar:
En iyi performans gösteren 10 fonu göster"ATA PORTFÖY" şirketine ait fonları listeleAAK ve DAH fonlarını karşılaştırAAK fonuna 10.000 TL yatırıp yıl başından bugüne kadar kaç para olacağını hesaplaHisse senedi fonlarının bu ayki performansını gösterSon enflasyon verilerini göster🔧 Geliştirme
Scripts
# TypeScript derlemesi (watch mode)
npm run dev
# Projeyi derle
npm run build
# Sunucuyu başlat
npm start
# Derleme dosyalarını temizle
npm run cleanProje Yapısı
src/
├── index.ts # Ana MCP sunucusu
├── api-client.ts # FonParam API client
├── tools.ts # MCP araçları tanımları
└── types.ts # TypeScript tip tanımları🤝 Katkıda Bulunma
Repoyu fork edin
Feature branch oluşturun (
git checkout -b feature/amazing-feature)Değişikliklerinizi commit edin (
git commit -m 'feat: amazing new feature')Branch'inizi push edin (
git push origin feature/amazing-feature)Pull Request oluşturun
📜 Lisans
Bu proje MIT lisansı altında lisanslanmıştır.
🔗 Bağlantılar
⚠️ Not
Bu sunucu FonParam API'sinin ücretsiz katmanını kullanır ve rate limiting kurallarına tabidir:
15 dakikada maksimum 25 istek
Günlük maksimum 100 istek
Yoğun kullanım için API anahtarı almayı düşünebilirsiniz.
Available Tools
15 toolsanalyze_fundC
Fon için yatırım analizi yapar
Inputs: code (required), startDate (required), initialInvestment (required), monthlyInvestment, +3 more.
company_detailsC
Portföy yönetim şirketi detaylarını getirir
Inputs: code (required), include_funds.
compare_fundsC
Fonları karşılaştırır (2-5 fon)
Inputs: codes (required).
fund_historical_dataC
Fonun geçmiş değerlerini getirir
Inputs: code (required), start_date, end_date, interval, +2 more.
fund_type_detailsC
Belirli bir fon tipinin detaylarını getirir
Inputs: type (required).
inflation_ratesC
Enflasyon verilerini listeler
Inputs: start_date, end_date.
latest_inflation_rateC
Son enflasyon verisini getirir
Inputs: no named parameters.
latest_statisticsC
Son istatistikleri getirir
Inputs: no named parameters.
list_companiesC
Portföy yönetim şirketlerini listeler
Inputs: page, limit, sort, order, +3 more.
list_fundsC
Yatırım fonlarını listeler ve filtreleme imkanı sunar
Inputs: page, limit, type, search, +7 more.
list_fund_typesC
Fon tiplerini listeler
Inputs: sort, order, min_total_funds, max_total_funds.
monthly_inflation_rateC
Belirli bir ay ve yıldaki enflasyon verisini getirir
Inputs: year (required), month (required).
statisticsC
Günlük istatistikleri listeler
Inputs: start_date, end_date, sort, order, +2 more.
statistics_by_dateC
Belirli bir günün istatistiklerini getirir
Inputs: date (required).
top_performing_fundsC
En iyi performans gösteren fonları getirir
Inputs: reference_funds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools have distinct purposes, such as analyze_fund for investment analysis and list_funds for listing funds. However, there is some overlap between inflation_rates, latest_inflation_rate, and monthly_inflation_rate, which could cause confusion in selecting the right tool for inflation data. Similarly, statistics, latest_statistics, and statistics_by_date have overlapping functions, though descriptions help differentiate them.
Tool names follow a consistent snake_case pattern with clear verb_noun structures, such as list_funds, compare_funds, and fund_historical_data. There are no deviations in naming conventions, making the set predictable and easy to navigate for an agent.
With 15 tools, the server is well-scoped for its domain of fund and investment analysis. Each tool appears to serve a specific purpose, such as analyzing funds, listing companies, or retrieving inflation data, without feeling excessive or insufficient for the apparent scope.
The tool set covers key areas like fund analysis, company details, inflation data, and statistics, providing good CRUD-like operations for the domain. Minor gaps exist, such as no explicit tools for updating or deleting data, but agents can likely work around these given the read-oriented nature of the server's purpose.
Related MCP Connectors
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Connect Claude, ChatGPT, Codex, Claude Code or another MCP client to your real multi-broker investment portfolio. Fortunest tracks stocks, ETFs and crypto across brokers and exchanges; its MCP server lets your agent read holdings, returns, allocation, risk, trades and tax lots, calculated by Fortunest rather than guessed by the model. Reads run on their own; every change waits for your approval in the Fortunest app, and no tool places an order or moves money. Sign-in is OAuth 2.1 and needs Fortunest Pro (14-day trial, no card). A free demo that needs no account is listed as Fortunest demo.
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.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude Desktop to access and analyze Chinese and global financial market data through the AKShare library.53MIT
- AlicenseNot gradedqualityNot gradedmaintenanceA Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.5MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables interaction with Polymarket prediction markets through Claude Desktop.31MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides access to a fund knowledge base. Enables users to query and interact with financial fund information through natural language.314 npmApache 2.0