`fas_exports`

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

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

Check US agricultural exports by commodity and destination. Returns export volumes, values, and trade partner details. Use fas_commodity_codes to find commodity codes (e.g., “corn”, “wheat”).

Parameters

Name	Type	Required	Description
`commodity`	string	yes	Commodity name (e.g., “corn”, “soybeans”, “wheat”, “beef”, “pork”, “cotton”) or commodity code
`country`	string	no	Destination country code (e.g., “CN” for China, “MX” for Mexico, “JP” for Japan). Optional — omit for all destinations.
`start_year`	string	no	Start year (e.g., “2020”). Optional.
`end_year`	string	no	End year (e.g., “2024”). Optional.

Example call

Arguments

{
  "commodity": "corn",
  "country": "CN",
  "start_year": "2020",
  "end_year": "2024"
}

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_exports","arguments":{"commodity":"corn","country":"CN","start_year":"2020","end_year":"2024"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fas_exports', {
  "commodity": "corn",
  "country": "CN",
  "start_year": "2020",
  "end_year": "2024"
});

More examples

{
  "commodity": "soybeans"
}

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	Export 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": [
        "exports"
      ],
      "description": "Trade direction"
    },
    "count": {
      "type": "integer",
      "description": "Number of records returned"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "year": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Export year"
          },
          "month": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Export month"
          },
          "partner": {
            "type": [
              "string",
              "null"
            ],
            "description": "Destination country/partner name"
          },
          "partner_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Destination country code"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Export value"
          },
          "quantity": {
            "type": [
              "number",
              "null"
            ],
            "description": "Export quantity"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement"
          }
        }
      },
      "description": "Export 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_exports