`fas_commodity_codes`

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

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 commodities matching filter
`categories`	object	Commodities grouped by category
`country_codes`	object	ISO 2-letter country codes and names
`note`	string	Usage note for the codes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total number of commodities matching filter"
    },
    "categories": {
      "type": "object",
      "description": "Commodities grouped by category",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "description": "Commodity code"
            },
            "name": {
              "type": "string",
              "description": "Commodity name"
            }
          },
          "required": [
            "code",
            "name"
          ]
        }
      }
    },
    "country_codes": {
      "type": "object",
      "description": "ISO 2-letter country codes and names",
      "additionalProperties": {
        "type": "string"
      }
    },
    "note": {
      "type": "string",
      "description": "Usage note for the 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