finhay-mcp-server 1.0.9 → 1.1.0

package/README.en.md

@@ -93,11 +93,9 @@ Open Claude and ask:
 | Tool | Description |
 |------|-------------|
 | `get_stock_realtime` | Realtime stock prices (single, multiple, or by exchange) |
-| `get_price_history_chart` | OHLCV price history |
+| `get_news` | Stock corporate events (dividends, rights issues, AGM...) |
+| `get_price_history_chart` | OHLCV price history (1D/5/15/30/1H/4H) |
 | `get_recommendation_reports` | Analyst recommendation reports |
-| `get_funds` | List of investment funds |
-| `get_fund_portfolio` | Fund portfolio composition |
-| `get_fund_months` | Available months for fund data |
 | `get_gold_prices` | Gold prices (SJC, DOJI, PNJ, BTMC) |
 | `get_gold_chart` | Gold price chart |
 | `get_gold_providers` | Gold prices by provider |
@@ -107,6 +105,8 @@ Open Claude and ask:
 | `get_all_financial_data` | All-in-one: gold, silver, crypto, rates, FX |
 | `get_bank_interest_rates` | Bank savings interest rates |
 | `get_crypto_top_trending` | Top trending cryptocurrencies |
+| `get_market_data` | Global indices (SP500, Nikkei...), big-tech stocks, commodities, forex |
+| `get_economic_calendar_events` | Upcoming economic events (CPI, Fed meetings, PMI...) |
 | `get_company_financial_overview` | Company financial overview (PE, PB, ROE, EPS...) |
 | `get_company_financial_analysis` | Financial analysis by year/quarter |
 | `get_financial_statement` | Financial statements (income, balance sheet, cash flow) |

package/README.md

@@ -93,11 +93,9 @@ Mở Claude, hỏi:
 | Tool | Mô tả |
 |------|-------|
 | `get_stock_realtime` | Giá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn) |
-| `get_price_history_chart` | Lịch sử giá OHLCV |
+| `get_news` | Sự kiện doanh nghiệp (cổ tức, quyền mua, ĐHĐCĐ...) |
+| `get_price_history_chart` | Lịch sử giá OHLCV (1D/5/15/30/1H/4H) |
 | `get_recommendation_reports` | Báo cáo phân tích từ chuyên gia |
-| `get_funds` | Danh sách quỹ đầu tư |
-| `get_fund_portfolio` | Danh mục của quỹ |
-| `get_fund_months` | Các tháng có dữ liệu quỹ |
 | `get_gold_prices` | Giá vàng (SJC, DOJI, PNJ, BTMC) |
 | `get_gold_chart` | Biểu đồ giá vàng |
 | `get_gold_providers` | Giá vàng theo nhà cung cấp |
@@ -107,6 +105,8 @@ Mở Claude, hỏi:
 | `get_all_financial_data` | Tổng hợp: vàng, bạc, crypto, lãi suất, tỷ giá |
 | `get_bank_interest_rates` | Lãi suất tiết kiệm ngân hàng |
 | `get_crypto_top_trending` | Crypto xu hướng |
+| `get_market_data` | Dữ liệu chỉ số global (SP500, Nikkei...), big-tech, hàng hoá, forex |
+| `get_economic_calendar_events` | Sự kiện kinh tế sắp tới (CPI, họp Fed, PMI...) |
 | `get_company_financial_overview` | Tổng quan tài chính doanh nghiệp (PE, PB, ROE, EPS...) |
 | `get_company_financial_analysis` | Phân tích tài chính theo năm/quý |
 | `get_financial_statement` | Báo cáo tài chính (BCTC, CDKT, LCTT) |

package/dist/client/FinhayClient.js

@@ -11,6 +11,9 @@ export class FinhayClient {
         this.http = axios.create({
             baseURL: baseUrl,
             timeout: 15000,
+            headers: {
+                'User-Agent': 'finhay-openapi (Skill)',
+            },
         });
     }
     /**

package/dist/index.js

@@ -17,7 +17,7 @@ const account = new AccountContext(client);
 await account.init();
 const server = new McpServer({
     name: 'finhay-mcp-server',
-    version: '1.0.0',
+    version: '1.1.0',
 });
 registerAllTools(server, client, account);
 const transport = new StdioServerTransport();

package/dist/tools/market.js

@@ -17,10 +17,29 @@ export function registerMarketTools(server, client) {
         const data = await client.get('/market/stock-realtime', query);
         return JSON.stringify(data.result, null, 2);
     }));
+    // --- News (corporate events) ---
+    server.tool('get_news', 'Get stock corporate events (rights issues, dividends, AGM dates, etc.) filtered by symbol(s) and/or date range. Dates must be DD/MM/YYYY format.', {
+        stock: z.string().optional().describe('Single stock symbol (e.g., VNM)'),
+        stocks: z.string().optional().describe('Comma-separated symbols (e.g., VNM,VIC,HPG)'),
+        from_date: z.string().optional().describe('Start date in DD/MM/YYYY (defaults to 1 year ago)'),
+        to_date: z.string().optional().describe('End date in DD/MM/YYYY (only applied when both dates provided)'),
+    }, safeHandler(async ({ stock, stocks, from_date, to_date }) => {
+        const query = {};
+        if (stock)
+            query.stock = stock.toUpperCase();
+        if (stocks)
+            query.stocks = stocks.toUpperCase();
+        if (from_date)
+            query.from_date = from_date;
+        if (to_date)
+            query.to_date = to_date;
+        const data = await client.get('/market/news', query);
+        return JSON.stringify(data.result, null, 2);
+    }));
     // --- Price history chart ---
     server.tool('get_price_history_chart', 'Get OHLCV price history chart for a stock. Timestamps must be Unix seconds (not milliseconds).', {
         symbol: z.string().describe('Stock symbol (e.g., FPT)'),
-        resolution: z.string().optional().describe('Resolution, only "1D" supported').default('1D'),
+        resolution: z.enum(['1D', '5', '15', '30', '1H', '4H']).optional().describe('Chart resolution: 1D (daily), 5/15/30 (minutes), 1H, 4H. Default 1D.').default('1D'),
         from: z.number().describe('Start timestamp in Unix SECONDS'),
         to: z.number().describe('End timestamp in Unix SECONDS'),
     }, safeHandler(async ({ symbol, resolution, from, to }) => {
@@ -37,25 +56,6 @@ export function registerMarketTools(server, client) {
         const data = await client.get(`/market/recommendation-reports/${symbol.toUpperCase()}`);
         return JSON.stringify(data.data, null, 2);
     }));
-    // --- Funds ---
-    server.tool('get_funds', 'Get list of all available investment funds with performance data', {}, safeHandler(async () => {
-        const data = await client.get('/market/funds');
-        return JSON.stringify(data.data, null, 2);
-    }));
-    server.tool('get_fund_portfolio', 'Get portfolio composition of a specific fund', {
-        fund: z.string().describe('Fund code (e.g., DCDS)'),
-        month: z.string().optional().describe('Month in YYYY-MM format (defaults to latest)'),
-    }, safeHandler(async ({ fund, month }) => {
-        const query = {};
-        if (month)
-            query.month = month;
-        const data = await client.get(`/market/funds/${fund}/portfolio`, query);
-        return JSON.stringify(data.data, null, 2);
-    }));
-    server.tool('get_fund_months', 'Get available months for a fund portfolio', { fund: z.string().describe('Fund code (e.g., DCDS)') }, safeHandler(async ({ fund }) => {
-        const data = await client.get(`/market/funds/${fund}/months`);
-        return JSON.stringify(data.data, null, 2);
-    }));
     // --- Gold ---
     server.tool('get_gold_prices', 'Get current gold prices from Vietnamese providers (SJC, DOJI, PNJ, BTMC)', {}, safeHandler(async () => {
         const data = await client.get('/market/financial-data/gold');
@@ -96,6 +96,38 @@ export function registerMarketTools(server, client) {
         const data = await client.get('/market/financial-data/cryptos/top-trending');
         return JSON.stringify(data.data, null, 2);
     }));
+    // --- Market data (global indices, big-tech, commodities, forex) ---
+    server.tool('get_market_data', 'Get historical data points for a global market index, big-tech stock, commodity, or forex pair. Results ordered descending by date.', {
+        type: z.enum([
+            'SP500', 'DOW_JONES', 'NASDAQ', 'RUSSELL2000', 'VIX', 'DXY',
+            'KOSPI', 'HANGSENG', 'SHANGHAI', 'NIKKEI',
+            'APPLE', 'MICROSOFT', 'ALPHABET', 'AMAZON', 'META', 'NVIDIA', 'TESLA',
+            'GOLD', 'SILVER', 'COPPER', 'CRUDE_OIL', 'BRENT_OIL', 'NATURAL_GAS',
+            'EURUSD', 'USDJPY', 'GBPUSD',
+        ]).describe('Market data type (US/Asian indices, big-tech stocks, commodities, forex)'),
+        limit: z.number().min(1).max(500).optional().describe('Number of data points (default 50, max 500)'),
+    }, safeHandler(async ({ type, limit }) => {
+        const query = { type };
+        if (limit)
+            query.limit = String(limit);
+        const data = await client.get('/market/financial-data/market', query);
+        return JSON.stringify(data.data, null, 2);
+    }));
+    // --- Economic calendar events ---
+    server.tool('get_economic_calendar_events', 'Get upcoming global economic events (CPI releases, Fed meetings, PMI announcements, etc.)', {
+        weeks: z.number().optional().describe('Number of weeks ahead to fetch (default 1)'),
+        country: z.enum([
+            'China', 'Euro Area', 'Japan', 'United States', 'United Kingdom', 'Vietnam',
+        ]).optional().describe('Filter by country (omit for all countries)'),
+    }, safeHandler(async ({ weeks, country }) => {
+        const query = {};
+        if (weeks)
+            query.weeks = String(weeks);
+        if (country)
+            query.country = country;
+        const data = await client.get('/market/financial-data/economic-calendar-events', query);
+        return JSON.stringify(data.data, null, 2);
+    }));
     // --- Company financials ---
     server.tool('get_company_financial_overview', 'Get financial overview for a company: PE, PB, EV/EBITDA, gross margin, ROE, EPS, dividend yield, NIM, ROA, and industry averages', {
         symbol: z.string().describe('Stock symbol (e.g., VNM)'),
@@ -133,13 +165,13 @@ export function registerMarketTools(server, client) {
         return JSON.stringify(data.data, null, 2);
     }));
     // --- Macro ---
-    server.tool('get_macro_data', 'Get macroeconomic indicators for Vietnam or US (CPI, PMI, IIP, FED rate, etc.)', {
+    server.tool('get_macro_data', 'Get macroeconomic indicators for Vietnam or US (CPI, PMI, IIP, FED rate, etc.). JP and DE are only valid when type=GOVERNMENT_10Y_BOND_YIELD.', {
         type: z.enum([
             'IIP', 'CPI', 'PMI', 'PCE', 'CORE_PCE', 'NFP', 'GOODS_RETAIL', 'SERVICE_RETAIL',
             'TOTAL_EXPORT', 'FDI_EXPORT', 'DOMESTIC_EXPORT', 'FED_FUNDS_RATE', 'INTERBANK_RATE',
             'GOVERNMENT_10Y_BOND_YIELD', 'UNEMPLOYMENT_RATE',
         ]).describe('Macro indicator type'),
-        country: z.enum(['VN', 'US']).describe('Country code'),
+        country: z.enum(['VN', 'US', 'JP', 'DE']).describe('Country code (JP/DE only for GOVERNMENT_10Y_BOND_YIELD)'),
         period: z.enum(['ONE_MONTH', 'ONE_YEAR', 'YTD']).optional().describe('Time period filter'),
     }, safeHandler(async ({ type, country, period }) => {
         const query = { type, country };

package/dist/tools/portfolio.js

@@ -14,7 +14,7 @@ export function registerPortfolioTools(server, client, account) {
         userId: z.string().optional().describe('User ID (auto-detected if omitted)'),
     }, safeHandler(async ({ userId }) => {
         const uid = account.resolveUserId(userId);
-        const data = await client.get(`/users/v4/users/${uid}/assets/summary`);
+        const data = await client.get(`/users/v3/users/${uid}/assets/summary`);
         return JSON.stringify(data.data, null, 2);
     }));
     // --- Portfolio ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "finhay-mcp-server",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "mcpName": "io.github.finhay/mcp-server",
   "description": "Finhay MCP Server — xem gia co phieu, danh muc dau tu qua Claude AI",
   "type": "module",