{
  "markdown": "# finhay-mcp-server\n\n<!-- mcp-name: io.github.finhay/mcp-server -->\n\n[Tiếng Việt](README.md) | [English](README.en.md)\n\nMCP Server cho Finhay Securities — xem giá cổ phiếu, danh mục đầu tư, vàng, crypto qua Claude AI.\n\n## Cài đặt\n\n### Bước 1: Tạo API Key\n\nVào [https://www.finhay.com.vn/finhay-skills](https://www.finhay.com.vn/finhay-skills) → Đăng nhập → Tạo API Key.\n\nBạn sẽ nhận được:\n- **API Key**: `ak_live_xxx`\n- **API Secret**: `sk_live_yyy`\n\n### Bước 2: Kết nối với Claude\n\nChọn **một trong ba** cách sau:\n\n#### Cách 1: Cài đặt tự động (không cần Node.js — khuyên dùng)\n\nMở Terminal (macOS) hoặc PowerShell (Windows), dán lệnh sau và nhấn Enter:\n\n**macOS:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/finhay/mcp-server/main/install.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https://raw.githubusercontent.com/finhay/mcp-server/main/install.ps1 | iex\n```\n\nScript sẽ tự động cài Node.js (nếu chưa có), hỏi API Key/Secret, và cấu hình Claude Desktop.\n\n#### Cách 2: Cài đặt nhanh (cần Node.js)\n\nNếu bạn đã có Node.js (>= 18), chạy lệnh sau:\n\n```bash\nnpx -y finhay-mcp-server --install\n```\n\nScript sẽ hỏi API Key/Secret (Secret được ẩn bằng dấu `*`), tự động ghi config vào Claude Desktop.\n\n#### Cách 3: Cấu hình thủ công\n\n**Bước 3a.** Tạo file credentials tại `~/.finhay/credentials/.env`:\n\n```\nFINHAY_API_KEY=ak_live_xxx\nFINHAY_API_SECRET=sk_live_yyy\n```\n\n**Bước 3b.** Thêm vào file config Claude Desktop:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Windows (Microsoft Store): `%LOCALAPPDATA%\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"finhay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"finhay-mcp-server\"]\n    }\n  }\n}\n```\n\n> API Key/Secret **không nằm** trong file config Claude — được lưu riêng tại `~/.finhay/credentials/.env` (dùng chung với Finhay Skills).\n\nSau khi hoàn tất, khởi động lại Claude Desktop là xong.\n\n### Bước 3: Sử dụng\n\nMở Claude, hỏi:\n\n- \"Giá cổ phiếu VNM hôm nay?\"\n- \"Xem danh mục đầu tư của tôi\"\n- \"So sánh FPT và VNM\"\n- \"Giá vàng SJC hôm nay bao nhiêu?\"\n- \"Lãi suất tiết kiệm ngân hàng nào cao nhất?\"\n- \"Chỉ số CPI Việt Nam gần đây?\"\n\n## Tools\n\n### Thị trường (20 tools)\n\n| Tool | Mô tả |\n|------|-------|\n| `get_stock_realtime` | Giá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn) |\n| `get_news` | Sự kiện doanh nghiệp (cổ tức, quyền mua, ĐHĐCĐ...) |\n| `get_price_history_chart` | Lịch sử giá OHLCV (1D/5/15/30/1H/4H) |\n| `get_recommendation_reports` | Báo cáo phân tích từ chuyên gia |\n| `get_gold_prices` | Giá vàng (SJC, DOJI, PNJ, BTMC) |\n| `get_gold_chart` | Biểu đồ giá vàng |\n| `get_gold_providers` | Giá vàng theo nhà cung cấp |\n| `get_silver_prices` | Giá bạc |\n| `get_silver_chart` | Biểu đồ giá bạc |\n| `get_metal_providers` | Giá vàng + bạc theo nhà cung cấp |\n| `get_all_financial_data` | Tổng hợp: vàng, bạc, crypto, lãi suất, tỷ giá |\n| `get_bank_interest_rates` | Lãi suất tiết kiệm ngân hàng |\n| `get_crypto_top_trending` | Crypto xu hướng |\n| `get_market_data` | Dữ liệu chỉ số global (SP500, Nikkei...), big-tech, hàng hoá, forex |\n| `get_economic_calendar_events` | Sự kiện kinh tế sắp tới (CPI, họp Fed, PMI...) |\n| `get_company_financial_overview` | Tổng quan tài chính doanh nghiệp (PE, PB, ROE, EPS...) |\n| `get_company_financial_analysis` | Phân tích tài chính theo năm/quý |\n| `get_financial_statement` | Báo cáo tài chính (BCTC, CDKT, LCTT) |\n| `get_macro_data` | Chỉ số vĩ mô (CPI, PMI, IIP, FED rate...) |\n| `get_market_session` | Trạng thái phiên giao dịch |\n\n### Tài khoản (8 tools)\n\n| Tool | Mô tả |\n|------|-------|\n| `get_account_summary` | Số dư: tiền mặt, chứng khoán, ký quỹ |\n| `get_asset_summary` | Tổng tài sản |\n| `get_portfolio` | Danh mục cổ phiếu với lãi/lỗ |\n| `get_pnl_today` | Lãi/lỗ hôm nay |\n| `get_order_history` | Lịch sử lệnh |\n| `get_order_book` | Sổ lệnh trong ngày |\n| `get_order_detail` | Chi tiết 1 lệnh |\n| `get_user_rights` | Quyền cổ đông: cổ tức, quyền mua... |\n\n\n## Yêu cầu\n\n- Node.js >= 18\n- Tài khoản Finhay Securities với API Key\n",
  "bytes": 4127,
  "sha": "fc1ea64ac0aa7bda3bab201106c3b2456f92678b0b7de53bef7ebfd10ce55904",
  "repo_slug": "finhay/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_finhay_mcp_server_c00493e8/readme"
}