Skip to content
MCP server

Peru Customs Data: Importers, Suppliers & HS Codes

MCP server for searching Peru customs shipments, importers and HS-code trade data

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

Similar MCP servers

About Peru Customs Data: Importers, Suppliers & HS Codes

Peru Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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.

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

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

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, 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.

What it does

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

Pricing

Freemium, from $100 a month

Free plan with 50 credits a month across all markets; Pro at $100/mo listed as not yet available

Prices change. Check thecompanyatlas.com before you buy.

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

How AIPoweredBot checks servers