`fas_commodity_codes`

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

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

Search agricultural commodity codes and names. Returns commodity IDs, descriptions, and categories. Use results with fas_production, fas_exports, and fas_imports.

Parameters

Name	Type	Required	Description
`category`	string	no	Filter by category: “Grains”, “Oilseeds”, “Meat”, “Dairy”, “Fiber”, “Sugar”, “Tropical” (optional)
`search`	string	no	Search keyword (e.g., “soy”, “wheat”). Optional.

Example call

Arguments

{
  "search": "soy",
  "category": "Oilseeds"
}

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_commodity_codes","arguments":{"search":"soy","category":"Oilseeds"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fas_commodity_codes', {
  "search": "soy",
  "category": "Oilseeds"
});

More examples

{
  "category": "Grains"
}

Response shape

Always returns: total, categories, country_codes, note

Field	Type	Description
`total`	integer	Total number of matching commodity codes
`categories`	object	Commodities grouped by category
`country_codes`	object	Mapping of ISO 2-letter country codes to country names
`note`	string	Usage guidance for commodity and country codes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total number of matching commodity codes"
    },
    "categories": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "description": "Commodity code"
            },
            "name": {
              "type": "string",
              "description": "Commodity name"
            }
          },
          "required": [
            "code",
            "name"
          ]
        }
      },
      "description": "Commodities grouped by category"
    },
    "country_codes": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Mapping of ISO 2-letter country codes to country names"
    },
    "note": {
      "type": "string",
      "description": "Usage guidance for commodity and country codes"
    }
  },
  "required": [
    "total",
    "categories",
    "country_codes",
    "note"
  ]
}

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_commodity_codes