Peru Customs Data: Importers, Suppliers & HS Codes
MCP server for searching Peru customs shipments, importers and HS-code trade data
- 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/peruAdd to Settings → Connectors → Add custom connector
https://thecompanyatlas.com/mcp/trade/peruAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"peru-import-export-data": {
"url": "https://thecompanyatlas.com/mcp/trade/peru"
}
}
}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/peruEnter 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.