Usda Market News

@pipeworx/usda-market-news

Market News による USDA AMS の家畜価格レポート：直販と畜牛、ボックスビーフおよび牛枝肉の部分肉、豚と豚肉、羊肉。日付付きの行には、レポート独自の基準（区分、販売基準、等級、重量範囲）と、安値／高値／加重平均価格が別々のフィールドとして保持されています。

Pipeworx の一部です。AI エージェントを 1878 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• ams_report_search(query?, species?, limit?) — タイトルの語句と家畜の種類で家畜価格レポートを検索します。レポート ID、レポートコード、各レポートに含まれるセクション、AMS が最後に公開した日時を返します。一致するものがない場合は、空のリストを返すのではなく、対象外の内容を示します。
• ams_report(report_id, section?, date?, start_date?, end_date?, limit?) — 1 つのレポートセクションから行を取得します。すべての応答にレポートの系列、タイトル、市場の種類、事務所が記載されます。日付を指定しない場合は、最新のレポート日を返します。AMS に行がない日付またはセクションを指定すると、空の配列やゼロではなく、レポートの最終公開日を含む status: "no_rows_for_request" を返します。

認証

キー不要です。

対象外の内容

青果物の出荷地点価格およびターミナル市場価格（ライム、トマト、タマネギなど、Specialty Crops Market News の品目）、穀物、家禽・卵のレポートは、登録済みアカウントキーが必要な別の AMS サービスで提供されています。このパックでは提供していません。ここでこれらをリクエストすると、その旨を示す no_match が返されます。提供するには、担当者がキーを登録する必要があります（Bruce の手順）。このパックがそのように装うことはありません。

価格を正しく読み取る

• 価格の系列は相互に置き換えられません。 生体または枝肉の直販と畜牛価格（区分、販売基準 LIVE FOB／DRESSED DELIVERED、等級）、ボックスビーフの部分肉価格（Choice／Select、枝肉重量 600～900 lb の部分肉価値）、豚肉の部分肉価格（FOB plant と FOB Omaha）は、同じ動物の価格であっても、それぞれ異なる数量です。比較する前に、各行の基準フィールドを確認してください。
• 価格帯は価格帯のままです。 price_range_low、price_range_high、weighted_avg_price は、AMS が公開する通りに別々のフィールドとして保持されています。ここでは平均化も集計も行いません。
• 単位。 データに単位フィールドはありません。AMS は LMR 価格をハンドレッドウェイト当たりのドル、重量をポンドで示します。各応答ではこれが unit_note に繰り返し記載されます。
• 数値は文字列です。 AMS が公開する形式のままです（"63,231"、"369.47"）。値が null のフィールドは行から除外されます。
• 日付。 ツール引数では ISO 形式で入出力されます。行の report_date は AMS の表記形式（MM/DD/YYYY）です。

データソース

• USDA Agricultural Marketing Service、Livestock Mandatory Price Reporting（Market News）。米国連邦政府のデータです。

知っておくとよい動作：AMS がまだ公開していない日付をリクエストすると、空のリストではなく、プレーンテキストの「No Results Found.」が返されます。これにより no_rows_for_request が検出されます。週次レポートは週に 1 日しか公開されないため、日付を指定すると該当するデータがないことがよくあります。同じレポート ID でも、セクションによって行の形が異なります（多くの牛レポートでは、Summary に頭数、Detail に価格が記載されます）。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "usda-market-news": {
      "url": "https://gateway.pipeworx.io/usda-market-news/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/usda-market-news/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントでは現在、パック独自のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況を確認する際の信頼できる情報源です。

これは意図的な設計であり、偶発的な多重化ではありません。メタツールを使うことで、このパックでは対応できない質問にも、ask_pipeworx を通じてカタログ全体を検索して回答できるため、MCP サーバーを追加する必要がありません。現時点では、メタツールを使わずにパックのエンドポイントだけをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フルの Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

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

どちらの URL も、同じゲートウェイと同じ 1878+ のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/ams_report_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"boxed beef cutout","species":"beef"}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/ams_report_search を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "usda-market-news": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-usda-market-news"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-usda-market-news

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答するのは、このパックのツールだけです。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使用しますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Usda Market News data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT