English Français العربية

io.github.finhay/mcp-server

Official registry Archived Finance and payments

Finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package finhay-mcp-server
Claude Code 
claude mcp add io-github-finhay-mcp-server -- npx -y finhay-mcp-server@1.0.8
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-finhay-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "finhay-mcp-server@1.0.8"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. finhay-mcp-server
  2. Cài đặt
  3. Tools
  4. Yêu cầu

finhay-mcp-server

Tiếng Việt | English

MCP Server cho Finhay Securities — xem giá cổ phiếu, danh mục đầu tư, vàng, crypto qua Claude AI.

Cài đặt

Bước 1: Tạo API Key

Vào https://www.finhay.com.vn/finhay-skills → Đăng nhập → Tạo API Key.

Bạn sẽ nhận được:

  • API Key: ak_live_xxx
  • API Secret: sk_live_yyy
Bước 2: Kết nối với Claude

Chọn một trong ba cách sau:

Cách 1: Cài đặt tự động (không cần Node.js — khuyên dùng)

Mở Terminal (macOS) hoặc PowerShell (Windows), dán lệnh sau và nhấn Enter:

macOS:

curl -fsSL https://raw.githubusercontent.com/finhay/mcp-server/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/finhay/mcp-server/main/install.ps1 | iex

Script sẽ tự động cài Node.js (nếu chưa có), hỏi API Key/Secret, và cấu hình Claude Desktop.

Cách 2: Cài đặt nhanh (cần Node.js)

Nếu bạn đã có Node.js (>= 18), chạy lệnh sau:

npx -y finhay-mcp-server --install

Script sẽ hỏi API Key/Secret (Secret được ẩn bằng dấu *), tự động ghi config vào Claude Desktop.

Cách 3: Cấu hình thủ công

Bước 3a. Tạo file credentials tại ~/.finhay/credentials/.env:

FINHAY_API_KEY=ak_live_xxx
FINHAY_API_SECRET=sk_live_yyy

Bước 3b. Thêm vào file config Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Windows (Microsoft Store): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "finhay": {
      "command": "npx",
      "args": ["-y", "finhay-mcp-server"]
    }
  }
}

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).

Sau khi hoàn tất, khởi động lại Claude Desktop là xong.

Bước 3: Sử dụng

Mở Claude, hỏi:

  • "Giá cổ phiếu VNM hôm nay?"
  • "Xem danh mục đầu tư của tôi"
  • "So sánh FPT và VNM"
  • "Giá vàng SJC hôm nay bao nhiêu?"
  • "Lãi suất tiết kiệm ngân hàng nào cao nhất?"
  • "Chỉ số CPI Việt Nam gần đây?"

Tools

Thị trường (20 tools)
ToolMô tả
get_stock_realtimeGiá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn)
get_newsSự kiện doanh nghiệp (cổ tức, quyền mua, ĐHĐCĐ...)
get_price_history_chartLịch sử giá OHLCV (1D/5/15/30/1H/4H)
get_recommendation_reportsBáo cáo phân tích từ chuyên gia
get_gold_pricesGiá vàng (SJC, DOJI, PNJ, BTMC)
get_gold_chartBiểu đồ giá vàng
get_gold_providersGiá vàng theo nhà cung cấp
get_silver_pricesGiá bạc
get_silver_chartBiểu đồ giá bạc
get_metal_providersGiá vàng + bạc theo nhà cung cấp
get_all_financial_dataTổng hợp: vàng, bạc, crypto, lãi suất, tỷ giá
get_bank_interest_ratesLãi suất tiết kiệm ngân hàng
get_crypto_top_trendingCrypto xu hướng
get_market_dataDữ liệu chỉ số global (SP500, Nikkei...), big-tech, hàng hoá, forex
get_economic_calendar_eventsSự kiện kinh tế sắp tới (CPI, họp Fed, PMI...)
get_company_financial_overviewTổng quan tài chính doanh nghiệp (PE, PB, ROE, EPS...)
get_company_financial_analysisPhân tích tài chính theo năm/quý
get_financial_statementBáo cáo tài chính (BCTC, CDKT, LCTT)
get_macro_dataChỉ số vĩ mô (CPI, PMI, IIP, FED rate...)
get_market_sessionTrạng thái phiên giao dịch
Tài khoản (8 tools)
ToolMô tả
get_account_summarySố dư: tiền mặt, chứng khoán, ký quỹ
get_asset_summaryTổng tài sản
get_portfolioDanh mục cổ phiếu với lãi/lỗ
get_pnl_todayLãi/lỗ hôm nay
get_order_historyLịch sử lệnh
get_order_bookSổ lệnh trong ngày
get_order_detailChi tiết 1 lệnh
get_user_rightsQuyền cổ đông: cổ tức, quyền mua...

Yêu cầu

  • Node.js >= 18
  • Tài khoản Finhay Securities với API Key

Frequently asked questions

What is io.github.finhay/mcp-server?

Finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI

How do I install io.github.finhay/mcp-server?

It runs on your machine. In Claude Code: claude mcp add io-github-finhay-mcp-server -- npx -y finhay-mcp-server@1.0.8. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.finhay/mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.finhay/mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.finhay/mcp-server?

It is published by finhay. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.