`nass_livestock`

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

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

Get US livestock inventory, slaughter counts, and production data by species, state, and time period. Analyze animal agriculture supply and production.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	NASS API key
`commodity`	string	yes	Livestock: “CATTLE”, “HOGS”, “CHICKENS”, “TURKEYS”, “SHEEP”, “MILK”, “EGGS”
`stat_category`	string	no	Statistic: “INVENTORY”, “SLAUGHTER”, “PRODUCTION” (default: “INVENTORY”)
`state`	string	no	State name (optional)
`year`	string	no	Year or range (optional)

Example call

Arguments

{
  "_apiKey": "your-nass-api-key",
  "commodity": "CATTLE",
  "stat_category": "INVENTORY",
  "state": "TEXAS"
}

curl

curl -X POST https://gateway.pipeworx.io/nass/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nass_livestock","arguments":{"_apiKey":"your-nass-api-key","commodity":"CATTLE","stat_category":"INVENTORY","state":"TEXAS"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nass_livestock', {
  "_apiKey": "your-nass-api-key",
  "commodity": "CATTLE",
  "stat_category": "INVENTORY",
  "state": "TEXAS"
});

More examples

{
  "_apiKey": "your-nass-api-key",
  "commodity": "HOGS",
  "stat_category": "SLAUGHTER",
  "year": "2024"
}

Response shape

Always returns: count, data, truncated

Field	Type	Description
`count`	integer	Number of records returned
`data`	array	Livestock inventory and production data
`truncated`	boolean	True if results exceed 200 records

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Number of records returned"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "commodity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Livestock type"
          },
          "stat_category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Statistic (INVENTORY, SLAUGHTER, PRODUCTION)"
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "State name"
          },
          "county": {
            "type": [
              "string",
              "null"
            ],
            "description": "County name"
          },
          "agg_level": {
            "type": [
              "string",
              "null"
            ],
            "description": "Aggregation level"
          },
          "year": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Year"
          },
          "frequency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Frequency"
          },
          "period": {
            "type": [
              "string",
              "null"
            ],
            "description": "Reference period"
          },
          "value": {
            "type": [
              "string",
              "null"
            ],
            "description": "Livestock count or production value"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Livestock statistic description"
          }
        }
      },
      "description": "Livestock inventory and production data"
    },
    "truncated": {
      "type": "boolean",
      "description": "True if results exceed 200 records"
    }
  },
  "required": [
    "count",
    "data",
    "truncated"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

nass_livestock