# HODL.VN — Vietnam market data

> HODL.VN — Vietnam market data is a freemium MCP server for finance and payments. Vietnamese stocks, macro, ETF flows, forex and crypto data with cited sources. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://hodl.vn/ai
- **Repository:** https://github.com/tohaitrieu/hodl-market-insight
- **MCP Registry name:** vn.hodl/market-data
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

HODL.VN is a Vietnamese market-data site, and this server brings its data into an assistant: HOSE, HNX and UPCoM stocks, the VN-Index, Vietnamese and world macro, foreign and proprietary trading flows, Bitcoin, Ethereum, Solana and gold ETF flows, forex, crypto, commodities and the site's own analysis articles. The README says every answer cites its source, and that the data is for reference rather than investment advice.

The README counts 53 tools. Market data is read-only; for a signed-in user the tools can also manage that user's own watchlists, price alerts, portfolio entries and accumulation plans, and create pending checkout orders paid on hodl.vn. Nothing touches other users' data.

Sign-in uses OAuth with a HODL.VN account for Claude, ChatGPT and Claude Code. Clients without OAuth, such as Cursor, VS Code and Gemini, use an API key or a personal connection URL. The free tier allows 100 calls a day; the Loyalty tier allows 2,500. The repository also ships a skill and a Claude Code plugin; its MIT licence covers those files, not the data.

## Features

- **Vietnam equities:** Prices and fundamentals for HOSE, HNX and UPCoM stocks plus the VN-Index.
- **Foreign and proprietary flows:** Foreign and proprietary trading activity.
- **ETF and crypto flows:** Bitcoin, Ethereum, Solana and gold ETF flows, plus crypto and forex.
- **Personal tools:** Watchlists, price alerts, portfolio deals and accumulation plans for the signed-in account.
- **Cited answers:** Responses are meant to cite their source.
- **Bundled skill and plugin:** A skill teaches correct tool order and units; a Claude Code plugin packages both.

## Good for

- Check a Vietnamese stock's price and valuation against its sector
- Compare Vietnamese and US inflation
- Track Bitcoin ETF flows this week
- Set price alerts and manage a watchlist from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http market-data https://mcp.hodl.vn/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.hodl.vn/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "market-data": {
      "url": "https://mcp.hodl.vn/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "market-data": {
      "serverUrl": "https://mcp.hodl.vn/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### What are the usage limits?

Free allows 100 calls per day; Loyalty allows 2,500 per day, with deeper history and fuller financial statements.

### How do I connect?

Sign in with OAuth in Claude, ChatGPT or Claude Code, or use an API key or personal URL in Cursor, VS Code or Gemini.

### Can it change my data?

Only your own watchlists, alerts, portfolio entries and similar items, with the client's confirmation prompt.

### Is it investment advice?

No. The README says the data is for reference only.

### Is HODL.VN — Vietnam market data free?

HODL.VN — Vietnam market data has a free plan, with paid plans for more usage or features.

### How do I add HODL.VN — Vietnam market data to Claude Code?

Run this command in your terminal: claude mcp add --transport http market-data https://mcp.hodl.vn/mcp

### What are the best alternatives to HODL.VN — Vietnam market data?

The closest alternatives to HODL.VN — Vietnam market data are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/hodl-vn-vietnam-market-data
