# Ukraine Customs Data: Importers, Suppliers & HS Codes

> Ukraine Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data. Search Ukraine customs import records by HS code, importer and supplier 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, Web
- **Website:** https://thecompanyatlas.com
- **Repository:** https://github.com/thecompanyatlas/ukraine-import-export-data-mcp
- **MCP Registry name:** io.github.TheCompanyAtlas/ukraine-import-export-data
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

The server gives an AI assistant access to customs declaration lines for Ukraine, so questions about who bought or shipped a product can be answered from declaration data rather than manual spreadsheet exports. Searches can filter by HS code prefix, buyer or seller name and id, country, ports, value and date, and the README notes that party names are stored largely in Cyrillic, so Ukrainian-script queries are recommended.

Beyond single shipments, the tools rank matched companies by declared value and line count per year, and break one company's trade down by HS chapter, partner country and counterparty. Ukraine coverage in the README runs from 2020 to 2026, and the connection is served by The Company Atlas, which the repository says runs the server itself.

The service suits trade analysts, sourcing teams and researchers who work with Ukrainian import data and want to query it conversationally from Claude, Cursor or another MCP-capable client. Free accounts receive 50 tool calls per month, and the vendor's pricing page lists a paid tier that it describes as not yet available.

## Features

- **HS code shipment search:** Finds individual customs lines by HS code prefix, with optional goods description substring matching.
- **Importer and supplier filters:** Matches buyer and seller names or registry ids, with semicolon-separated alternatives.
- **Company trade ranking:** Ranks matched companies by declared value and line count for each calendar year.
- **Product mix breakdown:** Splits one company's matched trade by HS code depth from chapter to full national code.
- **Country and partner breakdowns:** Shows a company's trade by year against partner countries and matched counterparties.

## Good for

- Identify the largest importers of a product such as generators or medicines into Ukraine
- Trace which foreign suppliers ship fuel or cars to a named Ukrainian buyer
- Compare a Ukrainian company's supplier concentration year by year
- Check the origin countries and ports behind specific import declarations

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

Enter a Name (for example "Ukraine 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": {
    "ukraine-import-export-data": {
      "type": "http",
      "url": "https://thecompanyatlas.com/mcp/trade/ukraine"
    }
  }
}
```

## Tools

- `Trade_search_trades`: Paginated customs shipment search with HS code, buyer, seller, country, port, value and date filters.
- `Trade_company_trade_volume_by_year`: Ranks importers or exporters by declared value and line counts per year.
- `Trade_hs_code_breakdown`: Splits one company's import and export value by HS chapter, heading or subheading.
- `Trade_year_country_breakdown`: Shows one company's trade value by year and counterparty country.
- `Trade_partner_breakdown`: Shows one company's trade value 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 a full company profile by id.

## FAQ

### Which country does the Ukraine server cover?

The README says it covers Ukraine import declarations for 2020 to 2026 and defaults to country code UA unless another country is requested.

### How are credits counted on the free plan?

The pricing page says each tool call counts as one credit, with 50 credits per calendar month on the free plan.

### How do I connect the server?

Add the Streamable HTTP URL https://thecompanyatlas.com/mcp/trade/ukraine as a custom MCP connector and sign in with Google when prompted.

### Are party names searchable in Latin script?

The README says party names are stored as declared, mostly in Ukrainian Cyrillic, and recommends searching in Cyrillic as well as Latin script.

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

Ukraine 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 Ukraine Customs Data: Importers, Suppliers & HS Codes to Claude Code?

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

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

The closest alternatives to Ukraine Customs Data: Importers, Suppliers & HS Codes are Russia Customs Data: Importers, Suppliers & HS Codes, Uganda Customs Data: Importers, Suppliers & HS Codes, Kazakhstan Customs Data: Importers, Suppliers & HS Codes, Pakistan Customs Data: Importers, Suppliers & HS Codes and Uzbekistan Customs Data: Importers, Suppliers & HS Codes.

## 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

- [Russia Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/russia-customs-data-importers-suppliers-and-hs-codes): Russia Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data.
- [Uganda Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/uganda-customs-data-importers-suppliers-and-hs-codes): Uganda Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data.
- [Kazakhstan Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/kazakhstan-customs-data-importers-suppliers-and-hs-codes): Kazakhstan Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data.
- [Pakistan Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/pakistan-customs-data-importers-suppliers-and-hs-codes): Pakistan Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and 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.
- [Paraguay Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/paraguay-customs-data-importers-suppliers-and-hs-codes): Paraguay Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data.
- [India Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/india-customs-data-importers-suppliers-and-hs-codes): India Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for freight and logistics.
- [Tanzania Customs Data: Importers, Suppliers & HS Codes](https://ai-powered.com/mcp/tanzania-customs-data-importers-suppliers-and-hs-codes): Tanzania Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for analytics and data.

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