# Vietnam Customs Data: Importers, Suppliers & HS Codes

> Vietnam Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for trade data. Searchable Vietnam customs shipment records, importers and HS-code trade data via MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $100 a month
- **Platforms:** API
- **Website:** https://thecompanyatlas.com
- **Repository:** https://github.com/thecompanyatlas/vietnam-import-export-data-mcp
- **MCP Registry name:** io.github.TheCompanyAtlas/vietnam-import-export-data
- **Categories:** [trade data](https://ai-powered.com/categories/trade-data)
- **Listing updated:** 2026-11-18

## About

The Vietnam trade server gives an AI assistant direct access to customs declarations filed in Vietnam, covering imports and exports from 2019 to 2026. You can look up individual shipments, rank the companies behind a product or trade route, and open a single company's trade by HS code, partner country and counterparty.

The connection runs over Streamable HTTP at a hosted endpoint on The Company Atlas, so the repository itself only documents setup and does not run a server. Access requires signing in with Google, and the free plan allows 50 tool calls per calendar month, one credit per call. The README notes that values may be declared in VND or USD, so totals need the currency column checked first.

The tool suite suits trade analysts, procurement teams and researchers who want to answer questions about who imports or exports a given goods category, and which suppliers a Vietnamese buyer uses, without exporting spreadsheets.

## Features

- **Shipment-level customs search:** Filter individual declarations by HS code prefix, buyer, seller, country, ports, value and date range.
- **Importer and exporter rankings:** Rank matched companies by declared value and line count for each calendar year.
- **HS code product mix:** Split one company's matched trade by HS chapter, heading or subheading, with official descriptions.
- **Country and partner breakdowns:** Total a company's trade by year against counterparty countries or matched partner companies.
- **Free plan with credit limit:** Free accounts receive 50 credits monthly, one per call, with access to the Vietnam data.

## Good for

- Finding the largest importers of a product such as laptops (HS 8471) into Vietnam
- Identifying foreign suppliers used by a specific Vietnamese importer
- Mapping which countries supply a manufacturer's imported components
- Reviewing a company's import and export mix by HS chapter before a sales outreach

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vietnam-import-export-data https://thecompanyatlas.com/mcp/trade/vietnam
```

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

```sh
https://thecompanyatlas.com/mcp/trade/vietnam
```

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

```json
{
  "mcpServers": {
    "vietnam-import-export-data": {
      "url": "https://thecompanyatlas.com/mcp/trade/vietnam"
    }
  }
}
```

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

```json
{
  "servers": {
    "vietnam-import-export-data": {
      "type": "http",
      "url": "https://thecompanyatlas.com/mcp/trade/vietnam"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vietnam-import-export-data": {
      "serverUrl": "https://thecompanyatlas.com/mcp/trade/vietnam"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://thecompanyatlas.com/mcp/trade/vietnam
```

Enter a Name (for example "Vietnam Customs Data: Importers, Suppliers & HS Codes"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "vietnam-import-export-data": {
      "type": "http",
      "url": "https://thecompanyatlas.com/mcp/trade/vietnam"
    }
  }
}
```

## Tools

- `Trade_search_trades`: Paginated customs shipment search with HS code, party, country, port, value and date filters.
- `Trade_company_trade_volume_by_year`: Ranks matched companies by declared value and line count per year.
- `Trade_hs_code_breakdown`: Splits one company's trade by HS prefix for imports and exports.
- `Trade_year_country_breakdown`: Totals one company's trade by year and counterparty country.
- `Trade_partner_breakdown`: Totals one company's trade by year and matched counterparty company.
- `Company_search`: Searches the global company registry by name or id, with optional country filter.
- `Company_get_by_id`: Returns the full company profile for an id.

## FAQ

### How do I connect the server?

Add the streamable HTTP URL https://thecompanyatlas.com/mcp/trade/vietnam as a custom MCP connector in your client, then sign in with Google when prompted.

### How many credits does the free plan include?

Free accounts get 50 credits per calendar month, with one credit counted per tool call. The allowance resets on the 1st in UTC.

### What years of Vietnam data are covered?

The README lists Vietnam coverage from 2019 to 2026.

### Is the data in one currency?

No. Declared values may be in VND or USD depending on the declaration, so the currency field should be checked before totalling.

### Is Vietnam Customs Data: Importers, Suppliers & HS Codes free?

Vietnam Customs Data: Importers, Suppliers & HS Codes has a free plan, with paid plans for more usage or features. Paid plans start at $100 a month.

### How do I add Vietnam Customs Data: Importers, Suppliers & HS Codes to Claude Code?

Run this command in your terminal: claude mcp add --transport http vietnam-import-export-data https://thecompanyatlas.com/mcp/trade/vietnam

### What are the best alternatives to Vietnam Customs Data: Importers, Suppliers & HS Codes?

The closest alternatives to Vietnam Customs Data: Importers, Suppliers & HS Codes are Philippines Customs Data: Importers, Suppliers & HS Codes, Rwanda Customs Data: Importers, Suppliers & HS Codes, Uzbekistan Customs Data: Importers, Suppliers & HS Codes and Tariff Code Finder.

## Where this comes from

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

## Alternatives

- [Philippines Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/philippines-customs-data-importers-suppliers-and-hs-codes): Philippines Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for trade data.
- [Rwanda Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/rwanda-customs-data-importers-suppliers-and-hs-codes): Rwanda Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for trade data.
- [Uzbekistan Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/uzbekistan-customs-data-importers-suppliers-and-hs-codes): Uzbekistan Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for maps and travel.
- [Tariff Code Finder](https://ai-powered.com/mcp/tariff-code-finder): Tariff Code Finder is a freemium MCP server for trade data.

---
Source: https://ai-powered.com/mcp/vietnam-customs-data-importers-suppliers-and-hs-codes
