# Peru Customs Data: Importers, Suppliers & HS Codes

> Peru Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for e-commerce. MCP server for searching Peru customs shipments, importers and HS-code trade data. 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/peru-import-export-data-mcp
- **MCP Registry name:** io.github.TheCompanyAtlas/peru-import-export-data
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

The Company Atlas exposes its Peru customs ledger to AI assistants through a remote MCP endpoint. Instead of exporting spreadsheets from a trade database, you ask questions in plain language and the server runs shipment searches, company rankings and per-company breakdowns against declaration records covering roughly 2019 to 2026.

The tools work at three levels. Shipment search returns individual declarations filtered by HS code prefix, buyer or seller name, country, ports, value and date. Volume ranking groups matched companies by declared value and line count for each year. Company breakdowns then split one matched company's trade by HS chapter, by partner country, or by named counterparty. Party names on customs forms are often abbreviated, so filtering by registry id is more reliable when it is known.

The README says the connection defaults to Peru imports and that the account uses Google sign-in with a monthly credit allowance. It suits analysts, procurement teams and researchers who want Peruvian importer and supplier data without learning a trade database interface.

## Features

- **Shipment record search:** Finds individual customs declarations by HS code prefix, buyer, seller, country, port, value and date.
- **Yearly company rankings:** Ranks matched importers or exporters by declared value and line count for each calendar year.
- **HS code breakdown:** Splits one company's import and export trade by HS chapter, heading or subheading.
- **Partner and country views:** Shows a company's trade by year against counterparty companies or partner countries.
- **Remote streamable HTTP endpoint:** Connects to Claude, Cursor and other MCP clients via a hosted URL with Google sign-in.

## Good for

- Identify the largest importers of a given HS-coded product into Peru
- Find which foreign suppliers ship goods to a specific Peruvian buyer
- Map where a Peruvian importer's purchases originate, year by year
- Compare supplier concentration for a company's purchasing

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

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

## 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 trade by HS chapter, heading or subheading.
- `Trade_year_country_breakdown`: Shows one company's trade by year and counterparty country.
- `Trade_partner_breakdown`: Shows one company's trade by year and matched counterparty company.
- `Company_search`: Searches the company registry by name or id with optional country filter.
- `Company_get_by_id`: Returns a full company profile by id.

## FAQ

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

The pricing page lists 50 credits a month on the free plan, with one credit per tool call, resetting on the 1st in UTC.

### Which Peru years are covered?

The README lists Peru data for 2019 to 2026, and the website markets page gives the same range.

### Does it need an API key?

The README says authentication uses Google OAuth sign-in rather than an API key.

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

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

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

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

The closest alternatives to Peru Customs Data: Importers, Suppliers & HS Codes are LowlandData E-commerce, Global Shopaholics, China With Me — Hardware Prototyping & Exhibition MCP and 1stPage — Amazon Seller & Vendor Analytics.

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

- [LowlandData E-commerce](https://ai-powered.com/mcp/lowlanddata-e-commerce): LowlandData E-commerce is a freemium MCP server for e-commerce.
- [Global Shopaholics](https://ai-powered.com/mcp/global-shopaholics): Global Shopaholics is a freemium MCP server for e-commerce.
- [China With Me — Hardware Prototyping & Exhibition MCP](https://ai-powered.com/mcp/china-with-me-hardware-prototyping-and-exhibition-mcp): China With Me — Hardware Prototyping & Exhibition MCP is a free MCP server for e-commerce.
- [1stPage — Amazon Seller & Vendor Analytics](https://ai-powered.com/mcp/1stpage-amazon-seller-and-vendor-analytics): 1stPage — Amazon Seller & Vendor Analytics is a freemium MCP server for marketing and seo.

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