Skip to content
MCP server

Vietnam Customs Data: Importers, Suppliers & HS Codes

Searchable Vietnam customs shipment records, importers and HS-code trade data via MCP

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

Similar MCP servers

About Vietnam Customs Data: Importers, Suppliers & HS Codes

Vietnam Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for trade data. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://thecompanyatlas.com/mcp/trade/vietnam
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vietnam-import-export-data": {
      "url": "https://thecompanyatlas.com/mcp/trade/vietnam"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $100 a month

Free plan with 50 credits a month; Pro at $100/month for 2,000 credits is not yet available.

Prices change. Check thecompanyatlas.com before you buy.

Vietnam Customs Data: Importers, Suppliers & HS Codes 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.

How AIPoweredBot checks servers