HODL.VN — Vietnam market data

vn.hodlv1.0.0更新于 Oct 9, 2026

Vietnamese stocks, VN and world macro, ETF flows, forex, crypto, commodities. Read-only, cited.

已验证Streamable HTTP可网页运行FinanceData & Analytics

概览

AI 生成的概览

让 AI 助手获取只读、带来源引用的越南及全球市场数据：股票、宏观、ETF 资金流、外汇、加密货币和大宗商品。

功能
这是一个远程 MCP 服务器，提供十个只读工具，覆盖越南股市（HOSE、HNX、UPCoM）、VN-Index、越南与全球宏观指标、比特币、以太坊、Solana 和黄金 ETF 资金流、外汇、加密货币、大宗商品以及 HODL.VN 的分析内容。回答会标注来源。配套技能会指导助手按正确顺序调用工具并正确理解单位。
适用场景
当助手需要越南市场或全球宏观的当前与历史数据、ETF 资金流数据，或外汇与大宗商品行情并附带引用时适用。适合研究与报告，而非交易执行。
运行要求
使用 mcp.hodl.vn 上的远程 HTTP 端点，无需本地运行时或软件包。需要免费的 HODL.VN 账号和 API key，通过 Authorization Bearer 请求头发送；Claude.ai 和 ChatGPT 改用个人连接 URL。需要网络访问。
安装前请注意
Authorization Bearer key 属于凭据：个人连接 URL 内嵌该 key，不应分享，泄露后应轮换。Free 与 Loyalty 套餐限制每日调用次数和历史数据深度。数据仅供参考，不构成投资建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 HODL.VN — Vietnam market data，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "market-data": {
      "type": "http",
      "url": "https://mcp.hodl.vn/mcp"
    }
  }
}

README

HODL.VN Market Insight

Dữ liệu thị trường HODL.VN ngay trong trợ lý AI: cổ phiếu Việt Nam (HOSE/HNX/UPCoM), VN-Index, vĩ mô Việt Nam và thế giới, dòng tiền ETF Bitcoin/Ethereum/Solana/vàng, forex, crypto, hàng hoá và bài phân tích HODL.VN — mọi câu trả lời dẫn nguồn.

Repo gồm:

  • MCP server hodl — https://mcp.hodl.vn/mcp (10 tool chỉ đọc).
  • Skill hodl-market-research — dạy AI gọi tool đúng thứ tự, đọc đúng đơn vị, luôn dẫn nguồn.
  • Plugin Claude Code hodl — gói sẵn cả hai.

Trang giới thiệu, danh sách tool và bảng hạn mức: https://hodl.vn/ai

1. Lấy API key (miễn phí)

Đăng nhập HODL.VN → Tài khoản → Kết nối AI: https://hodl.vn/tai-khoan/ket-noi-ai. Mỗi tài khoản có 1 key (Free hoặc Loyalty); sao chép lại bao nhiêu lần cũng được.

2. Cài đặt

Claude Code — plugin (MCP + skill)

bash
claude plugin marketplace add tohaitrieu/hodl-market-insightclaude plugin install hodl@hodl-market-insight

Lúc cài, Claude Code hỏi HODL.VN API key và cất vào kho bảo mật của máy (không ghi ra file cấu hình).

Chỉ cần MCP, không cần skill:

bash
claude mcp add --transport http hodl https://mcp.hodl.vn/mcp --header "Authorization: Bearer hodl_..."

Claude.ai / Claude Desktop

  1. Settings → Connectors → Add custom connector
  2. Name: HODL.VN
  3. Remote MCP server URL: URL kết nối riêng của bạn (dạng https://mcp.hodl.vn/mcp/k/…), sao chép tại Tài khoản → Kết nối AI.

Thêm skill: tải bản zip của thư mục skill (nén cả thư mục hodl-market-research) → Settings → Capabilities → Skills → Upload skill.

ChatGPT (web)

  1. Settings → Apps → Advanced settings → bật Developer mode
  2. Create app → Name: HODL.VN
  3. MCP Server URL: URL kết nối riêng (như trên)
  4. Authentication: No authentication

Cursor — ~/.cursor/mcp.json

json
{  "mcpServers": {    "hodl": {      "url": "https://mcp.hodl.vn/mcp",      "headers": { "Authorization": "Bearer hodl_..." }    }  }}

VS Code — .vscode/mcp.json

json
{  "servers": {    "hodl": {      "type": "http",      "url": "https://mcp.hodl.vn/mcp",      "headers": { "Authorization": "Bearer hodl_..." }    }  }}

URL kết nối riêng chứa key — đừng chia sẻ. Lộ key thì xoay key mới tại Tài khoản → Kết nối AI.

3. Hỏi thử

  • "Giá FPT hôm nay và P/E so với ngành?"
  • "Lạm phát Việt Nam và Mỹ 12 tháng gần đây?"
  • "Dòng tiền ETF Bitcoin tuần này?"
  • "EURUSD và vàng đang thế nào?"

Free và Loyalty

FreeLoyalty
Lượt gọi100/ngày2.500/ngày
Nến lịch sửD1 30, W1 12, H4 2001.000 mọi khung
BCTC4 quý / 3 năm8 quý / 5 năm, bảng đầy đủ
Ảnh chụp kỹ thuật—Có

Bảng đầy đủ, luôn cập nhật: https://hodl.vn/ai

English

HODL.VN market data inside your AI assistant: Vietnamese stocks, VN-Index, Vietnamese and world macro, Bitcoin/Ethereum/Solana/gold ETF flows, forex, crypto, commodities and HODL.VN analysis — every answer cites its source.

  1. Get a free API key at https://hodl.vn/tai-khoan/ket-noi-ai (sign-in required).
  2. Claude Code: claude plugin marketplace add tohaitrieu/hodl-market-insight then claude plugin install hodl@hodl-market-insight — you'll be asked for the API key, stored in secure storage.
  3. Other clients (Claude.ai, ChatGPT, Cursor, VS Code): see the snippets above; the endpoint is https://mcp.hodl.vn/mcp with Authorization: Bearer <key>, or your personal connection URL for Claude.ai / ChatGPT.

Data is for reference only, not investment advice.

Privacy policy: https://hodl.vn/chinh-sach-rieng-tu

License

MIT applies to the files in this repository only (plugin, skill, docs). It does not grant any rights to HODL.VN data returned by the MCP server, which is governed by HODL.VN's terms.

来源：README.md，提交 01b969c

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 9, 2026