`fas_imports`

Pack: fas · Endpoint: https://gateway.pipeworx.io/fas/mcp

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

Check US agricultural imports by commodity and origin country. Returns import volumes, values, and source country details. Use fas_commodity_codes to find commodity codes (e.g., “coffee”, “cocoa”).

Parameters

Name	Type	Required	Description
`commodity`	string	yes	Commodity name (e.g., “coffee”, “cocoa”, “sugar”, “beef”) or commodity code
`country`	string	no	Origin country code (e.g., “BR” for Brazil, “CO” for Colombia). Optional — omit for all origins.
`start_year`	string	no	Start year (optional)
`end_year`	string	no	End year (optional)

Example call

Arguments

{
  "commodity": "coffee",
  "country": "BR",
  "start_year": "2022"
}

curl

curl -X POST https://gateway.pipeworx.io/fas/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fas_imports","arguments":{"commodity":"coffee","country":"BR","start_year":"2022"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fas_imports', {
  "commodity": "coffee",
  "country": "BR",
  "start_year": "2022"
});

More examples

{
  "commodity": "cocoa"
}

Response shape

Always returns: commodity, commodity_code, direction, count, data, truncated

Field	Type	Description
`commodity`	string	Commodity name provided in request
`commodity_code`	string	Standardized commodity code
`direction`	string	Trade direction
`count`	integer	Number of records returned
`data`	array	Import records (max 100 returned)
`truncated`	boolean	Whether results were truncated to 100 records

Full JSON Schema

{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "description": "Commodity name provided in request"
    },
    "commodity_code": {
      "type": "string",
      "description": "Standardized commodity code"
    },
    "direction": {
      "type": "string",
      "enum": [
        "imports"
      ],
      "description": "Trade direction"
    },
    "count": {
      "type": "integer",
      "description": "Number of records returned"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Import year"
          },
          "month": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Import month"
          },
          "partner": {
            "type": [
              "string",
              "null"
            ],
            "description": "Origin country/partner name"
          },
          "partner_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Origin country code"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Import value"
          },
          "quantity": {
            "type": [
              "number",
              "null"
            ],
            "description": "Import quantity"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement"
          }
        }
      },
      "description": "Import records (max 100 returned)"
    },
    "truncated": {
      "type": "boolean",
      "description": "Whether results were truncated to 100 records"
    }
  },
  "required": [
    "commodity",
    "commodity_code",
    "direction",
    "count",
    "data",
    "truncated"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

fas_imports