Server data from the Official MCP Registry
Finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI
About
Finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI
Security Report
Valid MCP server (4 strong, 5 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
12 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-finhay-mcp-server": {
"args": [
"-y",
"finhay-mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
finhay-mcp-server
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)
| Tool | Mô tả |
|---|---|
get_stock_realtime | Giá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn) |
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_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 |
get_silver_prices | Giá bạc |
get_silver_chart | Biểu đồ giá bạc |
get_metal_providers | Giá vàng + bạc theo nhà cung cấp |
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) |
get_macro_data | Chỉ số vĩ mô (CPI, PMI, IIP, FED rate...) |
get_market_session | Trạng thái phiên giao dịch |
Tài khoản (8 tools)
| Tool | Mô tả |
|---|---|
get_account_summary | Số dư: tiền mặt, chứng khoán, ký quỹ |
get_asset_summary | Tổng tài sản |
get_portfolio | Danh mục cổ phiếu với lãi/lỗ |
get_pnl_today | Lãi/lỗ hôm nay |
get_order_history | Lịch sử lệnh |
get_order_book | Sổ lệnh trong ngày |
get_order_detail | Chi tiết 1 lệnh |
get_user_rights | Quyề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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
