Find US Importers with the EximAgent CLI or Connector

You need a ranked list of US importers for a product—not a scraped directory. This tutorial pulls that list from customs records with the EximAgent CLI or connector (hosted MCP server). We use green coffee, HS 090111, as the worked example. Output below is from a real run on 27 Oct 2026 (Asia/Saigon).

Customs data is incomplete by design. Treat the ranking as research, not a full market census. See customs data limitations.

What you'll use

• CLI — scripts and terminals
• Connector / MCP server — Claude, Cursor, Codex or another MCP client at https://mcp.eximagent.ai/mcp

Both are free to start. Sign in with Google (no API key to paste).

Install and sign in (CLI)

# macOS (Apple silicon) / Linux
curl -fsSL https://cli.eximagent.ai/install | sh

# Windows (PowerShell)
irm https://cli.eximagent.ai/install.ps1 | iex

eximagent login
eximagent whoami

Wire the MCP server into your tools:

eximagent connect claude-code   # or: codex / cursor
# Claude Code direct:
claude mcp add --transport http eximagent https://mcp.eximagent.ai/mcp --scope user

Chat apps: add the custom connector URL on /connectors.

Step 1 — pick the product code

If you only have a description, classify first:

eximagent hscode search --query "green coffee beans, not roasted" --limit 5

For this walkthrough we already know the six-digit code: 090111 (coffee, not roasted, not decaffeinated). Browse the code on the HS code lookup or the importer list for 090111.

Step 2 — rank US importers

Ask for importers into the US, grouped by company, ordered by value over the trailing 12 months:

eximagent analytics query \
  --groupBy importer \
  --measures value_usd,shipment_count \
  --filters '[{"dim":"hs6","op":"=","value":"090111"},{"dim":"dest","op":"=","value":"US"}]' \
  --timeWindow trailing-12m \
  --orderBy value_usd --descending --limit 8

In chat with the connector: "Who are the top US importers of HS 090111 in the last 12 months by value?"

Real output (27 Oct 2026)

Condensed from the JSON response for readability (columns shown: importer, shipment_count, value_usd). Source: EximAgent connector, exim__analytics__query, trailing-12m, dest=US, hs6=090111.

scope: customs records … HS 090111 (Coffee, not roasted : Not decaffeinated)
       × into US (United States) × over trailing-12m
coverage status: partial · confidence: 0.9

importer                     shipment_count      value_usd
STARBUCKS MANUFACTURING               552     280632787.98
OLAM AMERICAS                        1015     229494167.92
A LA ORDEN                            386     149402483.21
KEURIG GREEN MOUNTAIN                 171      86048554.97
STARBUCKS COFFEE                      145      79123354.76
NEUMANN GRUPPE USA                    375      76846155.54
THE FOLGER COFFEE                     148      52633050.90
VOLCAFE USA                           187      52573108.13

warning RESULT_CAPPED: The result is capped at 8 rows.

Page further with the offset the tool returns when you need the rest of the ranking. Results on the Free plan may differ.

Step 3 — what to do with the list

• Open a company on the 090111 importer list or pull a profile with the company tools.
• Outbound can research buyers and draft outreach emails; your own agent sends from your mailbox.
• For the raw shipments behind a name, use eximagent shipments search / eximagent company shipments (see bill-of-lading / shipment tutorial).

Caveats

• Rankings reflect filed customs records in coverage, not every importer that exists.
• Names are as they appear on filings; the same corporate family can appear under more than one string.
• Value and shipment counts are corpus aggregates for the filters you set—not audited financials.

FAQ

Do I need an API key for the CLI or connector?

No. Sign in with Google (OAuth). The hosted MCP server is at https://mcp.eximagent.ai/mcp.

Which command ranks US importers by value?

Use eximagent analytics query with --groupBy importer, filters on hs6 and dest (for example US), --timeWindow trailing-12m, and --orderBy value_usd --descending. The same tools power the connector in chat.

Is the ranking a complete list of every US importer?

No. Rankings reflect filed customs records in coverage, not every importer that exists. Coverage is reported as partial in the sample run. Treat the list as research, not a full market census.

Are the CLI and connector free?

Both are free to start. Sign in with Google; there is no API key to paste.

Next

• Classify a product and check its duty: Automate HS code classification and duty checks
• Compare customs MCP servers: trade-data-mcp-servers-compared