`br_trade_top_partners`

Pack: brazil-comex-stat · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/br_trade_top_partners for the schema, then POST the same URL with its arguments for the data.

Top countries trading a given Brazilian product (or overall) in a year — live from MDIC Comex Stat.

Tool description as the model sees it

Top partner countries for a Brazilian product in a given year, from MDIC Comex Stat (live proxy). Pass either an 8-digit NCM code or a 2-digit NCM/HS chapter; omit both for Brazil’s overall top trading partners that year. Sorted descending by value (USD FOB). Use for “top destinations for Brazilian soybeans in 2025” (ncm=“12019000”, year=“2025”) or “Brazil’s biggest export markets overall in 2025” (year=“2025”).

Parameters

Name	Type	Required	Description
`flow`	string	no	Trade direction: “export” or “import”. Defaults to “export”.
`ncm`	string	no	Full 8-digit NCM product code (e.g. “12019000” = soybeans). Use this OR chapter, not both; omit both for overall totals.
`chapter`	string	no	2-digit NCM/HS chapter code (e.g. “12” = oilseeds and grains).
`year`	string	yes	4-digit year (e.g. “2025”).
`limit`	number	no	Max partner countries to return. Defaults to 10, capped at 50.

Example call

Arguments

{
  "flow": "export",
  "ncm": "12019000",
  "year": "2025",
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/brazil-comex-stat/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"br_trade_top_partners","arguments":{"flow":"export","ncm":"12019000","year":"2025","limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('br_trade_top_partners', {
  "flow": "export",
  "ncm": "12019000",
  "year": "2025",
  "limit": 10
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the brazil-comex-stat pack

{
  "mcpServers": {
    "brazil-comex-stat": {
      "url": "https://gateway.pipeworx.io/brazil-comex-stat/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

br_trade_top_partners