`cross_search`

Pack: trade-compliance · Endpoint: https://gateway.pipeworx.io/trade-compliance/mcp

Search CBP CROSS — the US Customs and Border Protection ruling letters database — for how Customs has classified a product before. Returns binding and informational ruling letters with ruling number, date, subject, HTS tariff numbers assigned, and whether the ruling was later modified or revoked. Use this to find tariff classification precedent for an import: what HTS code CBP assigned to a similar article, country-of-origin and marking determinations, USMCA/NAFTA eligibility rulings, and valuation rulings. Search by product description (“lithium ion battery pack”, “cotton knit shirt”), by HTS code, or by ruling number.

Parameters

Name	Type	Required	Description
`query`	string	yes	Product description, HTS code, or ruling number, e.g. “lithium ion battery pack” or “8507.60”.
`hts`	string	no	Optional HTS/tariff number to narrow the search, e.g. “8507.60.0020”.
`since`	string	no	Only rulings issued on or after this date (YYYY-MM-DD).
`limit`	number,string	no	Max rulings to return (1-50, default 20).

Example call

Arguments

{
  "query": "lithium ion battery pack",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/trade-compliance/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cross_search","arguments":{"query":"lithium ion battery pack","limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('cross_search', {
  "query": "lithium ion battery pack",
  "limit": 5
});

More examples

{
  "query": "8507.60"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "trade-compliance": {
      "url": "https://gateway.pipeworx.io/trade-compliance/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

cross_search