# Nigeria Customs Data: Importers, Suppliers & HS Codes

> Nigeria Customs Data: Importers, Suppliers & HS Codes is a freemium MCP server for maps and travel. Search Nigeria customs shipment records, importers and suppliers via MCP for AI clients. 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/nigeria-import-export-data-mcp
- **MCP Registry name:** io.github.TheCompanyAtlas/nigeria-import-export-data
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

The server gives an AI assistant read access to customs declarations from Nigeria, covering roughly 2019 to 2025, alongside trade data from dozens of other markets on the same account. Instead of filtering spreadsheets by hand, you can ask for shipments by HS code prefix, buyer or seller name, country, port, value or date, and get the individual declared lines back with parties, goods, ports and invoice currency.

The tools also rank companies by yearly declared value and line count, break a single company's trade down by HS chapter or heading, and list its partner countries and matched counterparties. Where a party has been matched to a registry company, the response includes its id, so you can follow a supplier or buyer from one query to the next.

The service is aimed at analysts, procurement and sourcing teams, and researchers who want to query customs records conversationally from Claude or Cursor. The free plan uses a monthly credit allowance of 50 calls, and the README notes that the server defaults to Nigeria unless another country is requested.

## Features

- **Shipment record search:** Finds individual customs declarations filtered by HS code prefix, party names, country, ports, value and date.
- **Importer and exporter rankings:** Ranks matched companies by declared value and line count for each calendar year.
- **HS code product mix:** Splits one company's matched trade by HS prefix at chapter, heading, subheading or national-code depth.
- **Country and partner breakdowns:** Totals a company's trade by year and by partner country or matched counterparty.
- **Remote streamable HTTP server:** Connects to Claude, Cursor and other MCP clients through a hosted URL with Google sign-in.

## Good for

- Finding which companies import a given product into Nigeria in a chosen year
- Identifying a supplier base or concentration of purchasing for one importer
- Checking the origin country and goods description of specific declared shipments
- Mapping where a Nigerian company's imports come from, year by year
- Comparing importers of the same HS code across markets on one account

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `Trade_search_trades`: Search individual customs shipment lines by HS code, party, country, port, value and date.
- `Trade_company_trade_volume_by_year`: Rank matched companies by declared value and line count per year.
- `Trade_hs_code_breakdown`: Split one company's matched trade by HS prefix depth.
- `Trade_year_country_breakdown`: Total one company's trade by year and partner country.
- `Trade_partner_breakdown`: Total one company's trade by year and matched counterparty.

## FAQ

### Which years of Nigeria data are covered?

The listing states Nigeria records run from 2019 to 2025.

### How much does it cost?

The free plan includes all markets with 50 credits per month, one credit per tool call. A Pro tier at $100 per month with 2,000 credits is listed but not yet available.

### How do I connect it?

Add the server URL as a custom remote MCP connector in a compatible client such as Claude or Cursor, then sign in with Google when asked.

### Are all records matched to company ids?

No. The site notes that 2026 lines are still being matched, and rankings and partner breakdowns only include lines already tied to a registry company.

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

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

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

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

The closest alternatives to Nigeria Customs Data: Importers, Suppliers & HS Codes are Uzbekistan Customs Data: Importers, Suppliers & HS Codes and Nigeria Admin Divisions MCP by Wycord.

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

- [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.
- [Nigeria Admin Divisions MCP by Wycord](https://ai-powered.com/mcp/nigeria-admin-divisions-mcp-by-wycord): Nigeria Admin Divisions MCP by Wycord is an open-source MCP server for maps and travel.

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