`nass_prices`

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

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

Get prices received by US farmers for crops and livestock by commodity, state, and year. Track agricultural commodity price trends and market movements.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	NASS API key
`commodity`	string	yes	Commodity: “CORN”, “SOYBEANS”, “WHEAT”, “CATTLE”, “HOGS”, “MILK”, “CHICKENS”
`state`	string	no	State name (optional, defaults to national)
`year`	string	no	Year or range (optional)

Example call

Arguments

{
  "_apiKey": "your-nass-api-key",
  "commodity": "CORN",
  "state": "ILLINOIS",
  "year": "2024"
}

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_prices","arguments":{"_apiKey":"your-nass-api-key","commodity":"CORN","state":"ILLINOIS","year":"2024"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nass_prices', {
  "_apiKey": "your-nass-api-key",
  "commodity": "CORN",
  "state": "ILLINOIS",
  "year": "2024"
});

More examples

{
  "_apiKey": "your-nass-api-key",
  "commodity": "CATTLE",
  "year": "2020:2025"
}

Response shape

Always returns: count, data, truncated

Field	Type	Description
`count`	integer	Number of records returned
`data`	array	Prices received by farmers
`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": "Commodity name"
          },
          "stat_category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Always PRICE RECEIVED"
          },
          "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": "Price received by farmers"
          },
          "unit": {
            "type": [
              "string",
              "null"
            ],
            "description": "Price unit (e.g., $/BU, $/CWT)"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Price statistic description"
          }
        }
      },
      "description": "Prices received by farmers"
    },
    "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_prices