burkut-mcp 1.0.0 → 1.0.2

package/README.md

@@ -1,14 +1,25 @@
-# burkut-mcp 🦅
+<p align="center">
+  <img src="../assets/logo.png" alt="Bürküt Logo" width="100" />
+</p>
 
-> **Model Context Protocol (MCP) Server for Turkish Financial Markets (BIST, TEFAS, KAP, IPOs, Macro) powered by Bürküt API.**
+<h1 align="center">Bürküt MCP Server</h1>
 
-`burkut-mcp`, Türkiye finans piyasası verilerini (Borsa İstanbul hisseleri, TEFAS yatırım fonları, KAP bildirimleri, halka arzlar, temettüler ve makroekonomik veriler) doğrudan **Claude Desktop**, **Cursor**, **Windsurf** ve diğer LLM tabanlı yapay zeka ajanlarına bağlayan resmi olmayan/açık kaynak bir MCP sunucusudur.
+<p align="center">
+  <b>Claude Desktop, Cursor ve LLM tabanlı yapay zeka ajanları için Türkiye finans piyasası veri köprüsü.</b><br />
+  Borsa İstanbul (BIST), TEFAS Yatırım Fonları, KAP Bildirimleri, Halka Arzlar, Temettüler ve Makro Veriler.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/burkut-mcp"><img src="https://img.shields.io/npm/v/burkut-mcp?color=purple&style=flat-square&logo=npm&logoColor=white" alt="npm version" /></a>
+  <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/Protokol-MCP%20Standard%C4%B1-blueviolet?style=flat-square&logo=anthropic&logoColor=white" alt="MCP Protocol" /></a>
+  <a href="../LICENSE"><img src="https://img.shields.io/badge/Lisans-MIT-gray.svg?style=flat-square" alt="Lisans" /></a>
+</p>
 
 ---
 
-## ⚡ Hızlı Başlangıç (Quickstart)
+## Hızlı Başlangıç
 
-Kurulum yapmanıza gerek yoktur, `npx` ile anında çalıştırılabilir:
+Herhangi bir kurulum veya indirme gerektirmez. `npx` ile doğrudan çalıştırılır:
 
 ```bash
 npx -y burkut-mcp
@@ -17,10 +28,10 @@ npx -y burkut-mcp
 ### 1. Claude Desktop ile Kullanım
 
 Claude Desktop yapılandırma dosyanızı açın:
-* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-Aşağıdaki yapılandırmayı ekleyin:
+Aşağıdaki tanımı ekleyin:
 
 ```json
 {
@@ -29,54 +40,65 @@ Aşağıdaki yapılandırmayı ekleyin:
       "command": "npx",
       "args": ["-y", "burkut-mcp"],
       "env": {
-        "BURKUT_API_KEY": "YOUR_API_KEY_HERE"
+        "BURKUT_API_KEY": "BURKUT_API_ANAHTARINIZ"
       }
     }
   }
 }
 ```
 
-> **Not:** `BURKUT_API_KEY` opsiyoneldir. Anahtar girmeden de temel halka açık modda çalışır. Ancak daha yüksek kota ve kesintisiz erişim için [burkut.com/developers](https://burkut.com/developers) adresinden ücretsiz API Key alabilirsiniz.
+> **Önemli:** `BURKUT_API_KEY` zorunludur. Kotanızı takip etmek ve servisi kullanabilmek için [burkutportfoy.com/developer](https://burkutportfoy.com/developer) adresinden saniyeler içinde **ücretsiz API anahtarınızı** oluşturup buraya ekleyin.
 
 ---
 
 ### 2. Cursor IDE ile Kullanım
 
-Cursor Ayarları (`Settings`) -> `Features` -> `MCP Servers` -> `Add New MCP Server`:
-* **Name:** `burkut`
-* **Type:** `command`
-* **Command:** `npx -y burkut-mcp`
+1. **Cursor Settings** &rarr; **Features** &rarr; **MCP Servers** yolunu izleyin.
+2. **Add New MCP Server** butonuna tıklayın:
+   * **Name:** `burkut`
+   * **Type:** `command`
+   * **Command:** `npx -y burkut-mcp`
+   * **Env:** `BURKUT_API_KEY=BURKUT_API_ANAHTARINIZ`
 
 ---
 
-## 🛠️ Desteklenen Araçlar (MCP Tools)
+## Desteklenen MCP Araçları (Tools)
 
-| Tool | Açıklama |
-| :--- | :--- |
-| `burkut_search_funds` | TEFAS fonlarını koda, isme veya kategoriye göre filtreler; 1 ay, 3 ay, 6 ay ve 1 yıllık getirilerine göre sıralar. |
-| `burkut_get_fund_detail` | Belirli bir fonun (örn: `MAC`, `TI2`, `TCD`) tüm getiri periyotları, risk seviyesi ve güncel fiyat detaylarını çeker. |
-| `burkut_get_stock_quote` | BIST hisselerinin (örn: `THYAO`, `ASELS`, `KCHOL`) anlık/güncel fiyat, değişim % ve hacim verilerini getirir. |
-| `burkut_get_kap_announcements` | Kamuyu Aydınlatma Platformu'na (KAP) düşen şirket bildirimlerini veya genel piyasa bültenini çeker. |
-| `burkut_get_ipo_calendar` | Aktif ve yaklaşan Halka Arz (IPO) takvimini, lot fiyatlarını ve talep toplama tarihlerini listeler. |
-| `burkut_get_dividends` | BIST şirketlerinin temettü geçmişi, hisse başı net ödeme ve temettü verimi oranlarını getirir. |
-| `burkut_get_macro_indicators` | Türkiye resmi enflasyon oranları (TÜFE/ÜFE), serbest piyasa döviz kurları (USD/TRY, EUR/TRY) ve altın fiyatlarını getirir. |
+| Araç Adı | Parametreler | Açıklama |
+| :--- | :--- | :--- |
+| `burkut_search_funds` | `query`, `fundType`, `sortBy`, `limit` | TEFAS fonlarını filtreler; 1 ay, 3 ay, 6 ay ve 1 yıllık getirilerine göre sıralar. |
+| `burkut_get_fund_detail` | `symbol` (örn: `MAC`, `TI2`) | Belirli bir fonun tüm periyot getirilerini, risk seviyesini ve detaylı künyesini döner. |
+| `burkut_get_stock_quote` | `symbol` (örn: `THYAO`, `ASELS`) | BIST hissesinin 15 dk gecikmeli resmi fiyatını, günlük değişim oranını ve hacmini getirir. |
+| `burkut_list_stocks` | `symbols` (örn: `THYAO,ASELS`) | BIST hisselerini listeler veya virgülle ayrılmış hisseleri toplu çeker. |
+| `burkut_get_forex` | `symbol` (örn: `USD`, `EUR`) | Serbest piyasa ve TCMB döviz kurlarını getirir. |
+| `burkut_get_gold` | `symbol` (örn: `ALTIN`, `CEYREK_ALTIN`) | Gram altın, çeyrek altın ve ons altın piyasa fiyatlarını döner. |
+| `burkut_get_bonds` | - | Devlet tahvilleri ve hazine bonosu getirilerini listeler. |
+| `burkut_get_viop` | - | VİOP vadeli işlem ve opsiyon kontrat fiyatlarını listeler. |
 
 ---
 
-## 💬 Örnek İstemler (Prompt Örnekleri)
+## Örnek Türkçe İstekler (Promptlar)
+
+Claude Desktop veya Cursor'a doğrudan şu soruları sorabilirsiniz:
+
+* *"Bana TEFAS'taki hisse senedi yoğun fonlar arasında son 1 yılda en çok kazandıran 5 fonu listele ve yıllık getirilerini göster."*
+* *"MAC ve TI2 fonlarının risk puanlarını ve son 6 aylık performanslarını karşılaştır."*
+* *"Bugün KAP'a düşen önemli şirket bildirimlerini ve yeni iş ilişkilerini özetle."*
+* *"Bu hafta talep toplayacak veya aktif olan halka arzlar hangileri? Dağıtım yöntemleri nedir?"*
+* *"FROTO ve TUPRS şirketlerinin son temettü dağıtım oranlarını karşılaştır."*
+* *"TÜİK tarafından açıklanan son yıllık TÜFE enflasyon oranı ile güncel dolar kurunu getir."*
 
-Claude Desktop veya Cursor Composer'da doğrudan şunları sorabilirsiniz:
+---
+
+## Ortam Değişkenleri (Environment Variables)
 
-* *"Bana TEFAS'taki hisse senedi fonları arasında son 1 yılda en yüksek getiri sağlayan ilk 5 fonu listele ve yıllık getirilerini göster."*
-* *"MAC ve TI2 fonlarının risk seviyelerini ve son 6 aylık performanslarını karşılaştır."*
-* *"Bugün KAP'a düşen önemli şirket bildirimlerini özetle."*
-* *"Bu hafta talep toplayacak veya aktif olan halka arzlar hangileri? Fiyatları ve tarihleri nedir?"*
-* *"FROTO ve TUPRS'ın son temettü dağıtım oranlarını karşılaştır."*
-* *"Türkiye'deki son açıklanan yıllık TÜFE enflasyon oranı ile güncel dolar kurunu getir."*
+* `BURKUT_API_KEY`: Geliştirici API Anahtarınız (zorunludur, https://burkutportfoy.com/developer adresinden ücretsiz alınır).
+* `BURKUT_API_BASE_URL`: Hedef API adresi (Varsayılan: `https://api.burkutportfoy.com`).
+* `BURKUT_TIMEOUT_MS`: İstek zaman aşımı süresi milisaniye cinsinden (Varsayılan: `15000`).
 
 ---
 
-## 🔧 Geliştirme (Local Development)
+## Yerel Geliştirme (Local Development)
 
 ```bash
 git clone https://github.com/sametakan29/burkut-sdks.git
@@ -85,26 +107,20 @@ npm install
 npm run build
 ```
 
-Yerel test için:
+Yerel test:
 ```bash
 node dist/index.js
 ```
 
-Ortam Değişkenleri:
-* `BURKUT_API_KEY`: Bürküt Developer API anahtarınız (opsiyonel).
-* `BURKUT_API_BASE_URL`: Hedef API adresi (Varsayılan: `https://api.burkutportfoy.com`).
-* `BURKUT_TIMEOUT_MS`: İstek zaman aşımı süresi (Varsayılan: `15000` ms).
-
 ---
 
-## 💬 Destek ve İletişim
+## Destek ve İletişim
 
-Her türlü geri bildirim, özel veri seti talepleri veya hata bildirimleri için:
 * **E-posta:** [destek@burkutportfoy.com](mailto:destek@burkutportfoy.com)
-* **GitHub Issues:** [burkut-sdks/issues](https://github.com/sametakan29/burkut-sdks/issues)
+* **GitHub Issues:** [github.com/sametakan29/burkut-sdks/issues](https://github.com/sametakan29/burkut-sdks/issues)
 
 ---
 
-## 📄 Lisans
+## Lisans
 
-MIT © [Bürküt](https://burkutportfoy.com)
+Bu proje [MIT Lisansı](../LICENSE) ile korunmaktadır. Telif Hakkı &copy; 2026 Bürküt Finansal Teknolojiler.

package/dist/client.d.ts

@@ -8,12 +8,10 @@ export declare class BurkutApiClient {
     getFundDetail(symbol: string): Promise<any>;
     getStocks(symbols?: string[]): Promise<any[]>;
     getStockQuote(symbol: string): Promise<any>;
-    getKapAnnouncements(symbol?: string, page?: number, size?: number): Promise<any>;
-    getKapDetail(id: string): Promise<any>;
-    getIpoList(activeOnly?: boolean): Promise<any[]>;
-    getIpoDetail(symbol: string): Promise<any>;
-    getDividends(symbol?: string): Promise<any>;
-    getInflation(): Promise<any>;
     getForex(): Promise<any[]>;
+    getForexDetail(symbol: string): Promise<any>;
     getGold(): Promise<any[]>;
+    getGoldDetail(symbol: string): Promise<any>;
+    getBonds(): Promise<any[]>;
+    getViop(): Promise<any[]>;
 }

package/dist/client.js

@@ -14,19 +14,17 @@ export class BurkutApiClient {
         this.config = config || getConfig();
     }
     async request(path, options = {}) {
-        const { query, usePublicV1 } = options;
-        let resolvedPath = path;
+        const { query } = options;
+        // BURKUT_API_KEY zorunludur: Geliştirici veri borusu (/api/public/v1) için şarttır.
+        if (!this.config.apiKey || !this.config.apiKey.trim()) {
+            throw new Error("Bürküt API Anahtarı eksik! Bürküt MCP sunucusunu kullanabilmek için lütfen https://burkutportfoy.com/developer adresinden ücretsiz bir API anahtarı alın ve ayarlarınıza 'BURKUT_API_KEY' ortam değişkeni olarak ekleyin.");
+        }
         const headers = {
             'Accept': 'application/json',
-            'User-Agent': 'burkut-mcp/1.0.0',
+            'User-Agent': 'burkut-mcp/1.0.2',
+            'X-API-Key': this.config.apiKey.trim(),
         };
-        if (this.config.apiKey) {
-            headers['X-API-Key'] = this.config.apiKey;
-            if (usePublicV1 && !path.startsWith('/api/public/v1')) {
-                resolvedPath = `/api/public/v1${path.replace(/^\/api\/v1/, '')}`;
-            }
-        }
-        const url = new URL(`${this.config.baseUrl}${resolvedPath}`);
+        const url = new URL(`${this.config.baseUrl}${path}`);
         if (query) {
             for (const [key, value] of Object.entries(query)) {
                 if (value !== undefined && value !== null) {
@@ -55,10 +53,10 @@ export class BurkutApiClient {
                     throw new Error(`Enstrüman veya veri bulunamadı (404 Not Found): ${path}`);
                 }
                 if (response.status === 401 || response.status === 403) {
-                    throw new Error(`Yetkilendirme hatası (${response.status}): Geçersiz veya yetkisiz API Key. Lütfen burkutportfoy.com/developer üzerinden anahtarınızı kontrol edin.`);
+                    throw new Error(`Yetkilendirme hatası (${response.status}): Geçersiz veya iptal edilmiş API Key. Lütfen https://burkutportfoy.com/developer üzerinden anahtarınızı kontrol edin.`);
                 }
                 if (response.status === 429) {
-                    throw new Error(`İstek limiti aşıldı (429 Rate Limit): Lütfen birkaç saniye bekleyin veya daha yüksek kotalı bir plana geçin.`);
+                    throw new Error(`Kotanız doldu veya dakikalık hız sınırına takıldınız (429 Rate Limit): Lütfen birkaç saniye bekleyin veya https://burkutportfoy.com/developer adresinden planınızı yükseltin.`);
                 }
                 throw new Error(`Bürküt API Hatası (HTTP ${response.status}): ${errorDetail || response.statusText}`);
             }
@@ -76,75 +74,41 @@ export class BurkutApiClient {
     }
     // --- Funds (TEFAS) ---
     async getFunds() {
-        if (this.config.apiKey) {
-            return this.request('/funds', { usePublicV1: true });
-        }
-        return this.request('/api/v1/market/funds');
+        return this.request('/funds');
     }
     async getFundDetail(symbol) {
         const sym = normalizeSymbol(symbol);
-        if (this.config.apiKey) {
-            return this.request(`/funds/${sym}`, { usePublicV1: true });
-        }
-        return this.request(`/api/v1/market/funds/${sym}`);
+        return this.request(`/funds/${sym}`);
     }
     // --- Stocks (BIST) ---
     async getStocks(symbols) {
         const query = symbols && symbols.length > 0 ? { symbols: symbols.map(normalizeSymbol).join(',') } : undefined;
-        if (this.config.apiKey) {
-            return this.request('/stocks', { query, usePublicV1: true });
-        }
-        return this.request('/api/v1/market/stocks', { query });
+        return this.request('/stocks', { query });
     }
     async getStockQuote(symbol) {
         const sym = normalizeSymbol(symbol);
-        if (this.config.apiKey) {
-            return this.request(`/stocks/${sym}`, { usePublicV1: true });
-        }
-        return this.request(`/api/v1/market/stocks/${sym}`);
-    }
-    // --- KAP Announcements ---
-    async getKapAnnouncements(symbol, page = 1, size = 20) {
-        const sym = symbol ? normalizeSymbol(symbol) : undefined;
-        if (sym) {
-            return this.request(`/api/v1/kap/${sym}`, { query: { page, size } });
-        }
-        return this.request('/api/v1/kap', { query: { page, size } });
+        return this.request(`/stocks/${sym}`);
     }
-    async getKapDetail(id) {
-        return this.request(`/api/v1/kap/detail/${encodeURIComponent(id.trim())}`);
+    // --- Forex ---
+    async getForex() {
+        return this.request('/forex');
     }
-    // --- IPO (Halka Arz) ---
-    async getIpoList(activeOnly = false) {
-        if (activeOnly) {
-            return this.request('/api/v1/ipo/active');
-        }
-        return this.request('/api/v1/ipo');
+    async getForexDetail(symbol) {
+        return this.request(`/forex/${normalizeSymbol(symbol)}`);
     }
-    async getIpoDetail(symbol) {
-        return this.request(`/api/v1/ipo/${normalizeSymbol(symbol)}`);
+    // --- Gold ---
+    async getGold() {
+        return this.request('/gold');
     }
-    // --- Dividends (Temettü) ---
-    async getDividends(symbol) {
-        if (symbol) {
-            return this.request(`/api/v1/dividends/${normalizeSymbol(symbol)}`);
-        }
-        return this.request('/api/v1/dividends');
+    async getGoldDetail(symbol) {
+        return this.request(`/gold/${normalizeSymbol(symbol)}`);
     }
-    // --- Macro: Inflation, Forex, Gold ---
-    async getInflation() {
-        return this.request('/api/v1/turkey/inflation');
+    // --- Bonds ---
+    async getBonds() {
+        return this.request('/bonds');
     }
-    async getForex() {
-        if (this.config.apiKey) {
-            return this.request('/forex', { usePublicV1: true });
-        }
-        return this.request('/api/v1/market/forex');
-    }
-    async getGold() {
-        if (this.config.apiKey) {
-            return this.request('/gold', { usePublicV1: true });
-        }
-        return this.request('/api/v1/market/gold');
+    // --- VIOP ---
+    async getViop() {
+        return this.request('/viop');
     }
 }

package/dist/config.js

@@ -1,9 +1,23 @@
+function getCliArg(flag) {
+    if (typeof process === 'undefined' || !Array.isArray(process.argv))
+        return undefined;
+    const args = process.argv.slice(2);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === flag && i + 1 < args.length) {
+            return args[i + 1];
+        }
+        if (args[i].startsWith(`${flag}=`)) {
+            return args[i].slice(flag.length + 1);
+        }
+    }
+    return undefined;
+}
 export function getConfig() {
-    const envBaseUrl = process.env.BURKUT_API_BASE_URL;
-    // Default to production API if not specified
-    const baseUrl = (envBaseUrl || 'https://api.burkutportfoy.com').replace(/\/+$/, '');
-    const apiKey = process.env.BURKUT_API_KEY || undefined;
-    const timeoutMs = parseInt(process.env.BURKUT_TIMEOUT_MS || '15000', 10);
+    const envBaseUrl = process.env.BURKUT_API_BASE_URL || getCliArg('--base-url');
+    // Varsayılan olarak doğrudan geliştirici veri borusuna (/api/public/v1) bağlanır
+    const baseUrl = (envBaseUrl || 'https://api.burkutportfoy.com/api/public/v1').replace(/\/+$/, '');
+    const apiKey = (process.env.BURKUT_API_KEY || getCliArg('--api-key') || getCliArg('-k') || '').trim() || undefined;
+    const timeoutMs = parseInt(process.env.BURKUT_TIMEOUT_MS || getCliArg('--timeout') || '15000', 10);
     return {
         baseUrl,
         apiKey,

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListPromptsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { BurkutApiClient } from './client.js';
 import { TOOLS } from './tools.js';
 import { getConfig } from './config.js';
@@ -10,10 +10,12 @@ async function main() {
     const client = new BurkutApiClient(config);
     const server = new Server({
         name: 'burkut-mcp',
-        version: '1.0.0',
+        version: '1.0.2',
     }, {
         capabilities: {
             tools: {},
+            resources: {},
+            prompts: {},
         },
     });
     // Register tools list
@@ -26,6 +28,9 @@ async function main() {
             })),
         };
     });
+    // Clean empty handlers for optional protocol capabilities
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: [] }));
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({ prompts: [] }));
     // Handle tool calls
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
@@ -72,7 +77,7 @@ async function main() {
         console.error(`[burkut-mcp] API Key configured: ${config.apiKey.slice(0, 6)}...`);
     }
     else {
-        console.error(`[burkut-mcp] Running in public mode (No BURKUT_API_KEY provided)`);
+        console.error(`[burkut-mcp] WARNING: No BURKUT_API_KEY configured. Tool calls will require an API key from https://burkutportfoy.com/developer`);
     }
 }
 main().catch((err) => {

package/dist/tools.js

@@ -1,41 +1,49 @@
+function unwrap(res) {
+    if (res && typeof res === 'object' && 'data' in res) {
+        return res.data;
+    }
+    return res;
+}
 export const TOOLS = [
     {
         name: 'burkut_search_funds',
-        description: 'Search and filter Turkish TEFAS mutual funds (Yatırım Fonları) by code, name, category, or top performance yields (1 ay, 3 ay, 6 ay, 1 yıl).',
+        description: 'TEFAS yatırım fonlarını ara, filtrele ve getirilerine (1 ay, 3 ay, 6 ay, 1 yıl) göre sırala.',
         inputSchema: {
             type: 'object',
             properties: {
                 query: {
                     type: 'string',
-                    description: 'Search keyword matching fund code (e.g. "TI2", "MAC") or name (e.g. "Hisse", "Teknoloji", "Gümüş", "Eurobond").',
+                    description: 'Fon kodu (örn: "TI2", "MAC") veya isim anahtar kelimesi (örn: "Hisse", "Teknoloji", "Gümüş", "Eurobond").',
                 },
                 fundType: {
                     type: 'string',
-                    description: 'Filter by fund type, e.g. "Hisse Senedi Fonu", "Para Piyasası Fonu", "Değişken Fon", "Kıymetli Madenler Fonu", "Borçlanma Araçları Fonu".',
+                    description: 'Fon türü filtresi (örn: "Hisse Senedi Fonu", "Para Piyasası Fonu", "Değişken Fon", "Kıymetli Madenler Fonu").',
                 },
                 sortBy: {
                     type: 'string',
                     enum: ['yield1y', 'yield6m', 'yield3m', 'yield1m', 'dailyChangePct'],
-                    description: 'Sort field (highest to lowest). Default is "yield1y".',
+                    description: 'Sıralama ölçütü (büyükten küçüğe). Varsayılan: "yield1y".',
                 },
                 limit: {
                     type: 'number',
-                    description: 'Maximum number of funds to return (default: 15, max: 50).',
+                    description: 'Döndürülecek maksimum fon sayısı (varsayılan: 15, maksimum: 50).',
                 },
             },
         },
         handler: async (client, args) => {
             const raw = await client.getFunds();
             let list = [];
-            if (Array.isArray(raw)) {
-                list = raw;
+            const payload = unwrap(raw);
+            if (Array.isArray(payload)) {
+                list = payload;
             }
-            else if (raw && Array.isArray(raw.items)) {
-                list = raw.items;
+            else if (payload && Array.isArray(payload.items)) {
+                list = payload.items;
             }
             if (args.query) {
                 const q = String(args.query).toLowerCase().trim();
                 list = list.filter((f) => (f.symbol && f.symbol.toLowerCase().includes(q)) ||
+                    (f.code && f.code.toLowerCase().includes(q)) ||
                     (f.name && f.name.toLowerCase().includes(q)) ||
                     (f.fundType && f.fundType.toLowerCase().includes(q)));
             }
@@ -51,11 +59,11 @@ export const TOOLS = [
             });
             const limit = Math.min(Math.max(Number(args.limit) || 15, 1), 50);
             const results = list.slice(0, limit).map((f) => ({
-                kod: f.symbol,
+                kod: f.symbol || f.code,
                 isim: f.name,
                 tur: f.fundType || f.type,
-                fiyat: f.currentPrice,
-                gunlukDegisimPct: f.dailyChangePct,
+                fiyat: f.currentPrice ?? f.price,
+                gunlukDegisimPct: f.dailyChangePct ?? f.dailyChangePercent,
                 getiri1Ay: f.yield1m != null ? `%${f.yield1m}` : 'N/A',
                 getiri3Ay: f.yield3m != null ? `%${f.yield3m}` : 'N/A',
                 getiri6Ay: f.yield6m != null ? `%${f.yield6m}` : 'N/A',
@@ -71,137 +79,124 @@ export const TOOLS = [
     },
     {
         name: 'burkut_get_fund_detail',
-        description: 'Get in-depth metrics and multi-period returns for a specific Turkish TEFAS fund (e.g. MAC, TI2, TCD, GLDTR).',
+        description: 'Belirli bir TEFAS fonunun (örn: MAC, TI2, TCD) çoklu periyot getirilerini, risk seviyesini ve detaylı künyesini getirir.',
         inputSchema: {
             type: 'object',
             properties: {
                 symbol: {
                     type: 'string',
-                    description: 'The 3-5 character TEFAS fund code, e.g. "MAC", "TI2", "TCD", "AFT".',
+                    description: 'TEFAS fon kodu (örn: "MAC", "TI2", "TCD", "AFT").',
                 },
             },
             required: ['symbol'],
         },
         handler: async (client, args) => {
             const fund = await client.getFundDetail(args.symbol);
-            return JSON.stringify(fund, null, 2);
+            return JSON.stringify(unwrap(fund), null, 2);
         },
     },
     {
         name: 'burkut_get_stock_quote',
-        description: 'Get current price, percentage change, and volume for a Borsa Istanbul (BIST) equity (15-min delayed official feed).',
+        description: 'Borsa İstanbul (BIST) hisse senedinin 15 dk gecikmeli resmi fiyatını, günlük değişim oranını ve hacmini getirir.',
         inputSchema: {
             type: 'object',
             properties: {
                 symbol: {
                     type: 'string',
-                    description: 'Stock symbol without exchange prefix, e.g. "THYAO", "ASELS", "KCHOL", "GARAN".',
+                    description: 'Hisse sembolü (örn: "THYAO", "ASELS", "KCHOL", "GARAN").',
                 },
             },
             required: ['symbol'],
         },
         handler: async (client, args) => {
             const quote = await client.getStockQuote(args.symbol);
-            return JSON.stringify(quote, null, 2);
+            return JSON.stringify(unwrap(quote), null, 2);
         },
     },
     {
-        name: 'burkut_get_kap_announcements',
-        description: 'Fetch latest Kamuyu Aydınlatma Platformu (KAP) company disclosures, material events, financial balance sheets, and corporate announcements.',
+        name: 'burkut_list_stocks',
+        description: 'Borsa İstanbul (BIST) hisselerini listeler veya virgülle ayrılmış sembol listesinin verilerini toplu çeker.',
         inputSchema: {
             type: 'object',
             properties: {
-                symbol: {
+                symbols: {
                     type: 'string',
-                    description: 'Optional stock symbol to filter disclosures for a specific firm (e.g. "THYAO"). If omitted, market-wide disclosures are returned.',
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Number of notifications to retrieve (default: 10, max: 30).',
+                    description: 'Virgülle ayrılmış hisse sembolleri (örn: "THYAO,ASELS,EREGL"). Belirtilmezse popüler hisseleri döner.',
                 },
             },
         },
         handler: async (client, args) => {
-            const limit = Math.min(Math.max(Number(args.limit) || 10, 1), 30);
-            const data = await client.getKapAnnouncements(args.symbol, 1, limit);
-            return JSON.stringify(data, null, 2);
+            const symList = args.symbols
+                ? String(args.symbols).split(',').map((s) => s.trim()).filter(Boolean)
+                : undefined;
+            const stocks = await client.getStocks(symList);
+            return JSON.stringify(unwrap(stocks), null, 2);
         },
     },
     {
-        name: 'burkut_get_ipo_calendar',
-        description: 'Get the Turkish public offering (Halka Arz) calendar, including active/upcoming IPOs, offering price, dates, and subscription status.',
+        name: 'burkut_get_forex',
+        description: 'Serbest piyasa ve TCMB döviz kurlarını (USD/TRY, EUR/TRY, GBP/TRY vb.) getirir.',
         inputSchema: {
             type: 'object',
             properties: {
-                activeOnly: {
-                    type: 'boolean',
-                    description: 'If true, only returns active and upcoming IPOs. If false, returns recent IPO history too.',
+                symbol: {
+                    type: 'string',
+                    description: 'Belirli bir para birimi kodu (örn: "USD", "EUR"). Belirtilmezse tüm döviz kurlarını döner.',
                 },
             },
         },
         handler: async (client, args) => {
-            const data = await client.getIpoList(Boolean(args.activeOnly));
-            return JSON.stringify(data, null, 2);
+            if (args.symbol) {
+                const item = await client.getForexDetail(args.symbol);
+                return JSON.stringify(unwrap(item), null, 2);
+            }
+            const data = await client.getForex();
+            return JSON.stringify(unwrap(data), null, 2);
         },
     },
     {
-        name: 'burkut_get_dividends',
-        description: 'Fetch dividend distribution history, dividend yield %, payout dates, and net payment per share for BIST companies.',
+        name: 'burkut_get_gold',
+        description: 'Gram Altın, Çeyrek Altın, Yarım Altın, Tam Altın ve Ons fiyatlarını getirir.',
         inputSchema: {
             type: 'object',
             properties: {
                 symbol: {
                     type: 'string',
-                    description: 'Optional BIST stock symbol, e.g. "FROTO", "TUPRS", "EREGL". If omitted, upcoming market dividends are returned.',
+                    description: 'Belirli bir altın türü (örn: "ALTIN", "CEYREK_ALTIN"). Belirtilmezse tüm değerli madenleri döner.',
                 },
             },
         },
         handler: async (client, args) => {
-            const data = await client.getDividends(args.symbol);
-            return JSON.stringify(data, null, 2);
+            if (args.symbol) {
+                const item = await client.getGoldDetail(args.symbol);
+                return JSON.stringify(unwrap(item), null, 2);
+            }
+            const data = await client.getGold();
+            return JSON.stringify(unwrap(data), null, 2);
         },
     },
     {
-        name: 'burkut_get_macro_indicators',
-        description: 'Fetch Turkish macroeconomic indicators: official inflation rates (TÜFE / ÜFE monthly & annual), foreign exchange rates (USD/TRY, EUR/TRY), and precious metals (Gram Altın, Çeyrek Altın, Ons).',
+        name: 'burkut_get_bonds',
+        description: 'Devlet tahvilleri ve hazine bonoları faiz getirilerini listeler.',
         inputSchema: {
             type: 'object',
-            properties: {
-                category: {
-                    type: 'string',
-                    enum: ['all', 'inflation', 'forex', 'gold'],
-                    description: 'Category to fetch: "inflation" for CPI/PPI, "forex" for FX rates, "gold" for precious metals, or "all" (default).',
-                },
-            },
+            properties: {},
         },
-        handler: async (client, args) => {
-            const category = args.category || 'all';
-            const results = {};
-            if (category === 'all' || category === 'inflation') {
-                try {
-                    results.inflation = await client.getInflation();
-                }
-                catch (e) {
-                    results.inflation = { error: e.message };
-                }
-            }
-            if (category === 'all' || category === 'forex') {
-                try {
-                    results.forex = await client.getForex();
-                }
-                catch (e) {
-                    results.forex = { error: e.message };
-                }
-            }
-            if (category === 'all' || category === 'gold') {
-                try {
-                    results.gold = await client.getGold();
-                }
-                catch (e) {
-                    results.gold = { error: e.message };
-                }
-            }
-            return JSON.stringify(results, null, 2);
+        handler: async (client) => {
+            const data = await client.getBonds();
+            return JSON.stringify(unwrap(data), null, 2);
+        },
+    },
+    {
+        name: 'burkut_get_viop',
+        description: 'VİOP (Vadeli İşlem ve Opsiyon Piyasası) kontratlarını ve güncel uzlaşma fiyatlarını listeler.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+        handler: async (client) => {
+            const data = await client.getViop();
+            return JSON.stringify(unwrap(data), null, 2);
         },
     },
 ];

package/package.json

@@ -1,12 +1,10 @@
 {
   "name": "burkut-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Model Context Protocol (MCP) server for Turkish Financial Markets (BIST, TEFAS, KAP, IPOs, Macro) powered by Bürküt API.",
   "type": "module",
   "main": "dist/index.js",
-  "bin": {
-    "burkut-mcp": "./dist/index.js"
-  },
+  "bin": "./dist/index.js",
   "files": [
     "dist"
   ],