@pipeworx/nass

Connect: https://gateway.pipeworx.io/nass/mcp · Install: one-click buttons

Tools: 5

The USDA National Agricultural Statistics Service. Crop production, livestock inventory, prices, planted/harvested acres, yields — the official US agricultural data. State and county level for major commodities. Free, no auth (light rate limit).

Why this matters for AI agents

For agricultural commodity questions — supply outlook, price trends, regional production — NASS is the authoritative source. Used by USDA’s own analysts, commodity traders, and agribusiness. Pair with BLS for ag wages/PPI and Comtrade for global trade flows.

Common flows:

• Production estimates. “What’s the corn production forecast?” → nass_query({commodity: "CORN", agg_level: "NATIONAL"}) → annual and monthly forecasts.
• State-level breakdown. Same query with state: "IOWA" for state-specific.
• Livestock inventory. “How many cattle in Texas?” → nass_query({commodity: "CATTLE", state: "TEXAS"}).
• Prices. Average farm-gate prices by commodity and time period.

Used by the agricultural_commodity_brief recipe.

Auth

NASS Quickstats requires a free API key from https://quickstats.nass.usda.gov/api. Pass via _apiKey. Without a key, calls fail; with one, generous limits.

Major commodities tracked

Field crops: corn, soybeans, wheat, cotton, rice, sorghum, barley, oats, peanuts, sugar.

Livestock: cattle (calves, steers, dairy), hogs, sheep, poultry (broilers, layers, turkeys).

Specialty: vegetables (potatoes, tomatoes), fruit (apples, citrus), tree nuts, ornamentals.

Use exact USDA commodity names — the API is finicky about spelling and capitalization.

Update cadence

The crop-progress reports are the highest-frequency signal.

Common pitfalls

• Year-over-year confusion in monthly reports. Mid-season Crop Production reports give a current-year forecast revised monthly. Compare to prior year, not to last month’s forecast.
• Yield vs. production. Yield is per-acre (e.g., bushels/acre). Production is total (yield × harvested acres). They tell different stories.
• NASS isn’t WASDE. The World Agricultural Supply and Demand Estimates (WASDE) is a separate USDA report that synthesizes NASS + global data with supply/demand forecasts. For “outlook” questions, you may want WASDE.
• State-level data sparser for minor crops. Detailed state-level coverage is best for top-producing states. Smaller producers may aggregate to “Other states” or have suppressed data.
• Imperial units. Bushels, pounds, head, acres. Comtrade uses kilograms — convert when cross-referencing.
• Reference period. Cattle reports are point-in-time (January 1 inventory); crop reports often cover marketing year (varies by crop). Read the metadata.

Tools

• nass_query — Search USDA agricultural statistics by commodity, statistic, geography, and year. Returns production, yield, acreage, prices, and livestock data (e.g., commodity=“CORN”, state_fips=“06” for California
• nass_crop_production — Get US crop yields, production totals, and planted/harvested acreage by crop, state, and year. Quick access to major crop survey data.
• nass_prices — Get prices received by US farmers for crops and livestock by commodity, state, and year. Track agricultural commodity price trends and market movements.
• nass_livestock — Get US livestock inventory, slaughter counts, and production data by species, state, and time period. Analyze animal agriculture supply and production.
• nass_crop_progress — Get weekly crop progress reports with planting, emergence, blooming, harvest, and condition ratings (e.g., “GOOD”, “EXCELLENT”) by crop and state.