{"id":302587,"recorded_at":"2026-10-26T22:46:41.914001Z","observed_at":"2026-10-26T22:46:41.913954Z","subject_kind":"endpoint","subject":"3a46848f-c691-4ffa-8516-5095f7ec3ab2","kind":"mcp.tools","method":"probe.mcp/1","body":{"count":27,"tools":[{"description":"Derived comparison of ESR contracted export sales against GATS actual shipments for one commodity: total contracted, total shipped, and the gap in metric tons — a positive gap means sold but not yet shipped. Use to gauge the unshipped export backlog; use get_export_sales or get_trade_flows instead for the underlying weekly or monthly detail. Read-only; no API key. This is a computed aggregate across both stored datasets over all stored periods, not a USDA-published figure; totals are rounded to whole tons.","inputSchema":{"properties":{"commodity":{"description":"Commodity slug (see list_gats_commodities)","enum":["wheat","barley","corn","sorghum","soybeans","soybean_meal","soybean_oil","cotton","rice"],"type":"string"},"partner":{"description":"Partner country code (2-letter ISO/GENC, e.g. MX, CN) or omit for all partners","type":"string"}},"required":["commodity"],"type":"object"},"name":"compare_contracts_vs_shipments"},{"description":"Most recent weekly NASS crop condition ratings for corn, soybeans, or wheat — the share of the crop rated excellent, good, fair, poor, and very poor, plus a combined good+excellent percentage — from USDA NASS QuickStats. Use for current crop health; use get_crop_condition_history instead for week-by-week change across the season, and get_crop_progress for growth-stage pace. Read-only lookup of stored statistics; no API key. Ratings are published weekly in season, but the stored copy refreshes weekly, so the returned `period` (e.g. 2026-W30) is the freshest stored week, not necessarily the current one.","inputSchema":{"properties":{"commodity":{"default":"CORN","description":"Commodity (CORN, SOYBEANS, WHEAT). Default: CORN","type":"string"},"geography":{"default":"US","description":"US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US","type":"string"}},"required":[],"type":"object"},"name":"get_crop_condition"},{"description":"Week-by-week NASS crop condition ratings for corn, soybeans, or wheat across the growing season — each week's excellent/good/fair/poor/very poor shares plus a combined good+excellent percentage — from USDA NASS QuickStats. Use to track crop health trends or compare weeks within the season; use get_crop_condition instead when only the latest week matters. Read-only lookup of stored statistics; no API key. Returns up to `weeks` most recent stored weeks, oldest first (default 12, max 52); coverage is the current season, national plus major corn-belt states, and the stored copy refreshes weekly.","inputSchema":{"properties":{"commodity":{"default":"CORN","description":"Commodity (CORN, SOYBEANS, WHEAT). Default: CORN","type":"string"},"geography":{"default":"US","description":"US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US","type":"string"},"weeks":{"default":12,"description":"Number of most recent weeks to return (default 12, max 52)","type":"number"}},"required":[],"type":"object"},"name":"get_crop_condition_history"},{"description":"Most recent weekly NASS crop progress for corn, soybeans, or wheat — the share of the crop at each growth stage (planted, emerged, silking, harvested, and similar; the stages present vary by commodity) — from USDA NASS QuickStats. Use for current season pace; use get_crop_progress_history instead for week-by-week pace across the season, and get_crop_condition for health ratings. Read-only lookup of stored statistics; no API key. Progress is published weekly in season, but the stored copy refreshes weekly; the returned `period` (e.g. 2026-W30) is the freshest stored week.","inputSchema":{"properties":{"commodity":{"default":"CORN","description":"Commodity (CORN, SOYBEANS, WHEAT). Default: CORN","type":"string"},"geography":{"default":"US","description":"US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US","type":"string"}},"required":[],"type":"object"},"name":"get_crop_progress"},{"description":"Week-by-week NASS crop progress for corn, soybeans, or wheat across the growing season — each week's share of the crop at each growth stage (planted, emerged, silking, harvested, and similar) — from USDA NASS QuickStats. Use to track season pace or compare against earlier weeks; use get_crop_progress instead when only the latest week matters. Read-only lookup of stored statistics; no API key. Returns up to `weeks` most recent stored weeks, oldest first (default 12, max 52); the stages present vary by commodity and point in the season. Coverage is the current season, national plus major corn-belt states, and the stored copy refreshes weekly.","inputSchema":{"properties":{"commodity":{"default":"CORN","description":"Commodity (CORN, SOYBEANS, WHEAT). Default: CORN","type":"string"},"geography":{"default":"US","description":"US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US","type":"string"},"weeks":{"default":12,"description":"Number of most recent weeks to return (default 12, max 52)","type":"number"}},"required":[],"type":"object"},"name":"get_crop_progress_history"},{"description":"Annual NASS survey statistics — yield, production, planted or harvested area — for a commodity at national or state level, from USDA NASS QuickStats. These are survey estimates, not market prices. Use for production fundamentals; use get_crop_condition or get_crop_progress instead for in-season weekly crop status. Read-only lookup of stored statistics; no API key. Returns every stored period (year) for the requested statistic, most recent first; the stored copy refreshes weekly. Commodity, statistic, and geography are case-insensitive and default to CORN, YIELD, and US.","inputSchema":{"properties":{"commodity":{"default":"CORN","description":"Commodity (CORN, SOYBEANS, WHEAT, COTTON, SORGHUM, OATS, BARLEY, RICE). Default: CORN","type":"string"},"geography":{"default":"US","description":"US for national, or state code (IA, IL, etc.). Default: US","type":"string"},"stat":{"default":"YIELD","description":"Statistic type (YIELD, PRODUCTION, AREA PLANTED, AREA HARVESTED). Default: YIELD","type":"string"}},"required":[],"type":"object"},"name":"get_crop_stats"},{"description":"Weekly price history for one dairy product, from the same USDA MARS weekly dairy reports behind get_dairy_price. Use for trends across report weeks; use get_dairy_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent report rows, oldest first (default 30, max 365); geography defaults to US-Central and cheese reports use geography 'US'. Butter returns a withheld notice — USDA publishes only price differentials for butter, no US base price.","inputSchema":{"properties":{"geography":{"default":"US-Central","description":"Report region (US-Central, US-East, US-West; cheese uses US). Default: US-Central","type":"string"},"periods":{"default":30,"description":"Number of most recent report rows to return (default 30, max 365)","type":"number"},"product":{"description":"Dairy product (cheese, butter, dry_whey, fluid_milk). Butter prices are withheld — see description","enum":["butter","cheese","dry_whey","fluid_milk"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_dairy_history"},{"description":"Latest price for one dairy product, from USDA MARS weekly dairy reports — the same series get_dairy_history extends over time. Use for a current quote; use get_dairy_history instead for the weekly trend. Read-only lookup of stored reports; no API key. Geography defaults to US-Central (cheese reports are national and use geography 'US'). Butter is deliberately withheld: USDA publishes only price differentials for butter, no US base price, so butter returns a withheld notice instead of a misleading value.","inputSchema":{"properties":{"geography":{"default":"US-Central","description":"Report region (US-Central, US-East, US-West; cheese uses US). Default: US-Central","type":"string"},"product":{"description":"Dairy product (cheese, butter, dry_whey, fluid_milk). Butter prices are withheld — see description","enum":["butter","cheese","dry_whey","fluid_milk"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_dairy_price"},{"description":"Latest week of USDA export sales for one commodity from the FAS Export Sales Reporting (ESR) system — sales contracted by exporters, not yet necessarily shipped. Use for current foreign demand; use get_export_sales_history instead for the weekly trend, and get_trade_flows for actual shipped volumes. Read-only lookup of stored reports; no API key. ESR reports weekly (released Thursdays); returns the most recent stored week's weekly exports, outstanding sales, net sales for the current marketing year, and total commitments per destination country, each row with its reported unit. Omit `country` to include all destinations.","inputSchema":{"properties":{"commodity":{"description":"Commodity slug (see list_esr_commodities)","enum":["wheat","barley","corn","sorghum","soybeans","soybean_meal","soybean_oil","cotton","rice"],"type":"string"},"country":{"description":"GENC country code (e.g. CHN, MEX) or omit for all destinations","type":"string"}},"required":["commodity"],"type":"object"},"name":"get_export_sales"},{"description":"Weekly export sales time series for one commodity, and optionally one destination country, from the same FAS ESR weekly reports behind get_export_sales. Use for demand trends across weeks; use get_export_sales instead when only the latest week matters, and compare_contracts_vs_shipments to set contracted sales against actual shipments. Read-only lookup of stored reports; no API key. Returns up to `weeks` most recent weeks, oldest first (default 12, max 52); without a `country`, each week covers all destinations combined as stored.","inputSchema":{"properties":{"commodity":{"description":"Commodity slug (see list_esr_commodities)","enum":["wheat","barley","corn","sorghum","soybeans","soybean_meal","soybean_oil","cotton","rice"],"type":"string"},"country":{"description":"GENC country code (e.g. CHN, MEX) or omit for all destinations","type":"string"},"weeks":{"default":12,"description":"Number of most recent weeks to return (default 12, max 52)","type":"number"}},"required":["commodity"],"type":"object"},"name":"get_export_sales_history"},{"description":"Price history for one fertilizer product across report periods, from the same twice-monthly USDA MARS production cost reports behind get_fertilizer_price. Use for input-cost trends; use get_fertilizer_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent reports, oldest first (default 12, max 52 — roughly two years of twice-monthly reports).","inputSchema":{"properties":{"periods":{"default":12,"description":"Number of most recent report periods to return (default 12, max 52)","type":"number"},"product":{"description":"Product slug (e.g. anhydrous_ammonia, urea, dap)","enum":["anhydrous_ammonia","urea","dap","map","potash","liquid_n_28","liquid_n_32","ats","farm_diesel","biodiesel"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_fertilizer_history"},{"description":"Latest price for one fertilizer product from USDA MARS production cost reports (Illinois-led regional coverage) — the same series get_fertilizer_history extends over time. Use for a current input-cost quote; use get_spreads instead to relate fertilizer cost to corn or cattle prices. Read-only lookup of stored reports; no API key. The reports publish twice a month and are fetched on the 1st and 15th, so the latest price can be up to about two weeks old; returns the price, its unit (typically USD per ton), and the change versus the prior report.","inputSchema":{"properties":{"product":{"description":"Product slug (e.g. anhydrous_ammonia, urea, dap)","enum":["anhydrous_ammonia","urea","dap","map","potash","liquid_n_28","liquid_n_32","ats","farm_diesel","biodiesel"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_fertilizer_price"},{"description":"Daily cash price history for one grain commodity in one state, from the same USDA MARS daily reports behind get_grain_price. Use for trends or day-over-day comparison; use get_grain_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent daily report rows, oldest first; `periods` counts report rows, not calendar days (default 30, max 365).","inputSchema":{"properties":{"geography":{"default":"IL","description":"State/region code from a tracked MARS report (e.g. IL, IA, TX, PNW, GULF). Default: IL","type":"string"},"periods":{"default":30,"description":"Number of most recent report rows to return (default 30, max 365)","type":"number"},"product":{"description":"Grain slug (e.g. corn, soybeans, wheat)","enum":["corn","soybeans","wheat","sorghum","oats","barley","rice"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_grain_history"},{"description":"Latest cash grain price for one commodity in one state, from USDA MARS daily market reports — the same series get_grain_history extends over time. Use for a current quote; use get_grain_history instead for trends across days. Read-only lookup of stored reports; no API key. Returns the most recent report's price with its unit (USD per bushel in most markets) and market location; a commodity/state pair with no report returns a no-data error rather than a stale price.","inputSchema":{"properties":{"geography":{"default":"IL","description":"State/region code from a tracked MARS report (e.g. IL, IA, TX, PNW, GULF). Default: IL","type":"string"},"product":{"description":"Grain slug (e.g. corn, soybeans, wheat)","enum":["corn","soybeans","wheat","sorghum","oats","barley","rice"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_grain_price"},{"description":"Price history for one livestock category in one region, from the same USDA MARS reports behind get_livestock_price (daily direct-trade reports plus weekly auction summaries). Use for trends; use get_livestock_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent report rows, oldest first; `periods` counts report rows, not calendar days (default 30, max 365).","inputSchema":{"properties":{"geography":{"default":"IA","description":"Region or state code (e.g. IA, ECB, KS). Default: IA","type":"string"},"periods":{"default":30,"description":"Number of most recent report rows to return (default 30, max 365)","type":"number"},"product":{"description":"Livestock slug (e.g. fed_cattle, feeder_cattle, hogs)","enum":["fed_cattle","feeder_cattle","cows","hogs","sheep"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_livestock_history"},{"description":"Latest price for one livestock category in one region, from USDA MARS direct-trade and auction reports — the same series get_livestock_history extends over time. Use for a current quote; use get_livestock_history instead for trends. Read-only lookup of stored reports; no API key. Returns the most recent report's price and its unit (typically USD per cwt); direct-trade reports can skip weeks when no trades occur, and a category/region pair with no report returns a no-data error rather than a stale price.","inputSchema":{"properties":{"geography":{"default":"IA","description":"Region or state code (e.g. IA for Iowa direct trade, ECB for Eastern Cornbelt, or a state auction code). Default: IA","type":"string"},"product":{"description":"Livestock slug (e.g. fed_cattle, feeder_cattle, hogs)","enum":["fed_cattle","feeder_cattle","cows","hogs","sheep"],"type":"string"}},"required":["product"],"type":"object"},"name":"get_livestock_price"},{"description":"Derived input-to-output price spreads computed from the latest stored Magpie prices: corn-to-nitrogen cost broken down per fertilizer product (bushels of corn per ton of product and per pound of actual N), the soybean-to-corn price ratio, and the feeder-to-fed cattle spread. Use for planting and feeding economics; use the raw price tools (get_grain_price, get_fertilizer_price, get_livestock_price) instead for the quotes behind a spread. Read-only; no API key. These are Magpie calculations over stored USDA MARS prices, not USDA-published figures; a spread is omitted when either side has no stored price. Geography defaults to IL and applies to both sides of each spread.","inputSchema":{"properties":{"geography":{"default":"IL","description":"State/region code used for both sides of the spreads (e.g. IL, IA). Default: IL","type":"string"}},"required":[],"type":"object"},"name":"get_spreads"},{"description":"Monthly US agricultural export shipments by destination, from USDA GATS (Census trade data) — quantities and values actually shipped, not sales contracted. Use for realized trade volumes; use get_export_sales instead for contracted-but-unshipped demand, and compare_contracts_vs_shipments for the sold-versus-shipped gap. Read-only lookup of stored Census data; no API key. Coverage is a rolling 24 months, refreshed monthly; quantities are in metric tons with values in USD. Some commodities are withheld when GATS unit inconsistencies fail a dollars-per-ton sanity check — a withheld result says so explicitly instead of returning bad numbers.","inputSchema":{"properties":{"commodity":{"description":"Commodity slug (see list_gats_commodities)","enum":["wheat","barley","corn","sorghum","soybeans","soybean_meal","soybean_oil","cotton","rice"],"type":"string"},"months":{"default":12,"description":"Number of months of flows to return (default 12, max 24)","type":"number"},"partner":{"description":"Partner country code (2-letter ISO/GENC, e.g. MX, CN) or omit for all partners","type":"string"}},"required":["commodity"],"type":"object"},"name":"get_trade_flows"},{"description":"Revision history of one WASDE projection figure (default ending_stocks) across monthly reports — how the estimate for a commodity and marketing year moved as successive WASDE reports landed. Use to study estimate revisions; use get_wasde_projection instead for the full current balance sheet. Read-only lookup of stored projections; no API key. Returns up to 24 monthly report values, oldest first, each with its report date and unit, for the requested commodity, attribute, and country (default WORLD).","inputSchema":{"properties":{"attribute":{"default":"ending_stocks","description":"Projection attribute (beginning_stocks, production, imports, exports, domestic_consumption, ending_stocks)","enum":["beginning_stocks","production","imports","exports","domestic_consumption","ending_stocks"],"type":"string"},"commodity":{"description":"Commodity slug (e.g. corn, wheat, soybeans)","enum":["corn","wheat","soybeans","soybean_meal","soybean_oil","rice","barley","cotton"],"type":"string"},"country":{"default":"WORLD","description":"Country code (WORLD, US, BR, AR). Default: WORLD aggregate","type":"string"}},"required":["commodity"],"type":"object"},"name":"get_wasde_history"},{"description":"Latest USDA WASDE supply/demand projections for one commodity — beginning stocks, production, imports, exports, domestic consumption, and ending stocks — from the FAS PSD database behind the monthly WASDE report. Use for the current balance-sheet outlook; use get_wasde_history instead to see how a single figure has been revised across reports. Read-only lookup of stored projections; no API key. Returns the newest stored report's values for the requested marketing year (default: the current marketing year, where e.g. 2026 means the 2025/26 season) and country (default WORLD aggregate; US, BR, and AR are also tracked).","inputSchema":{"properties":{"commodity":{"description":"Commodity slug (e.g. corn, wheat, soybeans, rice, cotton)","enum":["corn","wheat","soybeans","soybean_meal","soybean_oil","rice","barley","cotton"],"type":"string"},"country":{"default":"WORLD","description":"Country code (WORLD, US, BR, AR). Default: WORLD aggregate","type":"string"},"market_year":{"description":"Marketing year (e.g. 2026 = 2025/26 season). Default: current marketing year","type":"number"}},"required":["commodity"],"type":"object"},"name":"get_wasde_projection"},{"description":"Lists the dairy product slugs this API tracks (cheese, butter, dry_whey, fluid_milk) with display labels. Use to discover valid `product` values before calling get_dairy_price or get_dairy_history. Read-only; no API key. Butter is listed for completeness but its price is withheld in the price tools — USDA reports no US base price for butter.","inputSchema":{"properties":{},"type":"object"},"name":"list_dairy_products"},{"description":"Lists the commodities tracked in USDA export sales reporting (wheat, barley, corn, sorghum, soybeans, soybean meal, soybean oil, cotton, rice) with their FAS commodity codes. Use to discover valid `commodity` slugs before calling get_export_sales or get_export_sales_history. Read-only; no API key. Slugs map to FAS 'all' aggregate commodity codes where available.","inputSchema":{"properties":{},"type":"object"},"name":"list_esr_commodities"},{"description":"Lists the fertilizer product slugs this API tracks (anhydrous ammonia, urea, DAP, MAP, potash, liquid N 28/32, ATS, farm diesel, biodiesel) with display labels. Use to discover valid `product` values before calling get_fertilizer_price or get_fertilizer_history. Read-only; no API key. The list is the configured catalog across the tracked MARS production cost reports, not a live availability check.","inputSchema":{"properties":{},"type":"object"},"name":"list_fertilizer_products"},{"description":"Lists the commodities tracked in GATS trade flows (matched to Census data by HS chapter) with display labels. Use to discover valid `commodity` slugs before calling get_trade_flows or compare_contracts_vs_shipments. Read-only; no API key. The list is the configured catalog — individual commodities can still be withheld in get_trade_flows when their source data fails sanity checks.","inputSchema":{"properties":{},"type":"object"},"name":"list_gats_commodities"},{"description":"Lists the grain commodity slugs this API tracks (corn, soybeans, wheat, sorghum, oats, barley, rice) with display labels. Use to discover valid `product` values before calling get_grain_price or get_grain_history. Read-only; no API key. The list is the configured MARS catalog, not a live availability check — a listed product can still have no report for a given state.","inputSchema":{"properties":{},"type":"object"},"name":"list_grain_products"},{"description":"Lists the livestock category slugs this API tracks (fed_cattle, feeder_cattle, cows, hogs, sheep) with display labels. Use to discover valid `product` values before calling get_livestock_price or get_livestock_history. Read-only; no API key. The list is the configured catalog, not a live availability check — some categories trade sporadically and can have no recent report in a region.","inputSchema":{"properties":{},"type":"object"},"name":"list_livestock_products"},{"description":"Lists the commodities tracked in WASDE projections (corn, wheat, soybeans, soybean meal, soybean oil, rice, barley, cotton) with their FAS PSD commodity codes. Use to discover valid `commodity` slugs before calling get_wasde_projection or get_wasde_history. Read-only; no API key.","inputSchema":{"properties":{},"type":"object"},"name":"list_wasde_commodities"}]},"body_sha256":"e0119dd55d6b6e42b39f4f496dbce245f737e15a4cf0aafe2e4fc4f44681a264","prev_id":null,"leaf":"0xa76df69680a02cd212222c9bc97e24ec80b9f2464eee4b1fcadfb16103130ebb","leaf_text":"{\"body\":\"e0119dd55d6b6e42b39f4f496dbce245f737e15a4cf0aafe2e4fc4f44681a264\",\"id\":302587,\"kind\":\"mcp.tools\",\"method\":\"probe.mcp/1\",\"observed_us\":1793054801913954,\"prev\":null,\"subject\":\"3a46848f-c691-4ffa-8516-5095f7ec3ab2\",\"subject_kind\":\"endpoint\"}","day":{"day":"2026-10-26","leaves":296695,"root":"0xf43e8dcc3d451a4788b26be904c55e8c4c0fa75c9666796c51db38d37e2c0df8","chained":"0x702d5ac508f08b0d1accf36af25822d8e5660367494edd17a642fb61e158a57a","anchor_chain":"eip155:5042002","anchor_tx":"0x495162f8936e19f0039918feebe6c307f327cd6bf8c37219620b1970041fa9ae","anchor_block":69251483},"proof":["0xa76dc52e28624b6b42a741d2c940b50f82919a30c56109ea7453508d663c35b3","0xce171f0fb7bac377c20cd861094593604bc204a679381e01db00f37ab9f7a0ec","0xf66ab47c3846f22b855d98835b0fd00c47fff487eedcf48963794e27f75d4379","0xa66b1e23a5670f927cdfd2c4c0b17229cb835782764b89b5107a67cdf63d2083","0xa36eb3141fb79cd7f34c2bcacb8dd4178b092fb6bfdc34b94d812b82b1659d71","0xa138922bd08dfb7030dbae0911fca05a52c03eba924a48877e42148a6db9fe51","0x2ca31706180822e96e4802bdd72e776629fe3e27e98f5a861b0e18a716aaecca","0x26ae4d973900261aaaac1bfd0d9fcd43145f36b7f6d52f868ec5653fd1f5eb58","0xf9b9521b260b61c0d5bbedbd9b0486a7b2a6dd13514ee4cfa62f934dc2767522","0x96a6c36f66ccdce2fc9d08bc551d6e8a2e7e8f76cf469865819b5bc277877605","0xfd7db9a5ff472cfefafacbeb7f7f7dc6fc7e28e7e0d99e3b79d231f0d5f46aee","0x1e464fcb484a1e782f9fe44be5118a9de934eb533c96ba10fc7d20e3a3e4711c","0x292ebdce6b8d3d7ef08ad646a0fd97dee9313ab55c1a350807d9f3013794c37a","0x428106f4ae4ec142f17aebf6fa50935242f8d3f1c211cf95d6351d03d11da2b7","0x62a900133713919f4eed33d8336876b7a6d538233b8a4f3ed03b29aa44f5bad0","0x1ac20d30773e1f4f2f811540e9a99b5cca9177c9e2e029acc0d80cf3f1d11f0f","0xd21942ae3214eff88e08ab04884fd4b11958b51af9a0741b7668e2d07a2c56c9","0x9a9024edb5069d88a324facb310a5ce8e495214bbaa968f077bede437390194f","0x9b9ce5b74b9bab5121612ef6b64920a8d453cbf311096a423eef9702747e868a"]}