`faostat_dimensions`

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

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

The valid codes for one dimension of one FAOSTAT domain — the country/area codes, element codes (production quantity, area harvested, yield, import value, …), item codes (wheat, cattle, nitrogen fertiliser, …) or years a domain actually carries. Call this BEFORE faostat_data: FAOSTAT codes are numeric and domain-specific, so guessing them returns nothing rather than an error. Example: domain “QCL” dimension “element” lists production quantity (5510), area harvested (5312) and yield (5412); domain “QCL” dimension “item” lists the 278 crops and livestock products.

Parameters

Name	Type	Required	Description
`domain_code`	string	yes	FAOSTAT domain code from faostat_domains, e.g. “QCL”.
`dimension`	string	yes	Which dimension to list: “area” (countries and territories), “areagroup” (regional aggregates), “element” (the measured quantity), “item” (the commodity), “itemsgroup” (commodity aggregates), “year”, “flag” (data-quality flags) or “unit”.
`search`	string	no	Case-insensitive substring filter on the code label, e.g. “wheat”.
`limit`	number	no	Max codes to return (default 50, max 1000).

Example call

Arguments

{
  "domain_code": "QCL",
  "dimension": "element"
}

curl

curl -X POST https://gateway.pipeworx.io/faostat/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"faostat_dimensions","arguments":{"domain_code":"QCL","dimension":"element"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('faostat_dimensions', {
  "domain_code": "QCL",
  "dimension": "element"
});

More examples

{
  "domain_code": "QCL",
  "dimension": "item",
  "search": "wheat"
}

Connect

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

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

See Getting Started for client-specific install steps.

faostat_dimensions