Budget Resolutions

@pipeworx/budget-resolutions

予算機能および会計年度ごとの議会予算決議案（予算に関する両院合同決議、H.Con.Res. / S.Con.Res.）の目標値と、同じ年度の米国財務省の実績値を並べて確認できます。

Pipeworx の一部です。AI エージェントを1858以上のライブデータソースに接続するMCPゲートウェイです。独立した非公式の統合であり、上流プロバイダーとは提携も、承認も、公表もされていません。

ツール

• budget_resolution_find(fiscal_year) - その会計年度にどの予算決議が存在し、各決議がどこまで進んだかを確認します。両院で採択済み、一方の院を通過、または提出のみのいずれかです。該当する決議がない年度では、空のリストではなく、名前付きのreason_code（no_resolution_exists、no_adopted_resolution、before_coverage）とfound:falseを返します。
• budget_resolution_targets(fiscal_year, function?, target_year?, adopted_only?, package_id?) - 決議が定める歳入、新規予算権限、支出額、赤字および債務に加え、予算年度と決議が対象とする後続年度について、各予算機能（国防、保健、メディケア、純利払いなど）ごとの予算権限と支出額を返します。採択済みの決議を返し、採択された決議がない場合は、一方の院を通過した最も進展した提案をadopted:falseと明示して返します。すべての応答には、機能別の数値を年度ごとに合計し、決議に記載された総額と並べたreconciliationブロックが含まれます。
• budget_vs_actual(fiscal_year, function?, adopted_only?) - 目標値と、財務省の実績である歳入、支出、そこから算出した赤字、機能別支出を並べて返します。予算決議がない年度でも、実績値と予算側の不足理由を示す名前付きの値を返します。未完了の会計年度にはcomparable:falseのフラグが付きます。

認証

プラットフォームキー（PLATFORM_DATAGOV_KEY。govinfoおよびcongressパックですでに使用されているdata.govキー）を使用します。_apiKeyによるBYOオーバーライドにも対応しています。

データソース

• 米国議会が採択した予算に関する両院合同決議。米国政府出版局（議会法案）が公開しています。法案本文は第103議会（1993年）から始まるため、対象となる最初の予算年度は1994会計年度です。
• 米国財務省、月次財務諸表（予算機能別支出、予算内および予算外の合計）。

米国連邦政府のパブリックドメインデータです。データは保存されません。各呼び出しで決議本文を読み込み、解析します。

次の担当者が改めて調べずに済むように

• 予算内ベースです。 決議に記載された歳入、支出、機能別の数値には、社会保障の予算外部分は含まれません。そのため、budget_vs_actualでは合計を財務省の予算内合計と比較します（参考として、統合合計も併せて返します）。また、社会保障機能（650）には同条件での比較ではないことを示すフラグが付きます。
• 準備金と節減のプレースホルダー（機能920、930）は決議に含まれますが、財務省には対応する項目がありません。これらは削除せず、注記付きで返します。そのため、決議の支出総額が実際の支出を大幅に下回ることがあります。
• ステータスは法案本文のバージョンコードから読み取ります。 enrは両院で採択済みを示します。上院で受領された下院発の決議（pcs、rfs、eh）は下院のみ通過したことを示します。そのため、上院を通過しなかった下院の計画にはadopted:falseが付きます。
• 登録済み法案のメタデータ上のタイトルが、別の決議のタイトルになっている場合があります。 照合は決議の系列ごとに行い、解析した本文が指定された会計年度から始まっていない場合、呼び出しは拒否されます（text_year_mismatch）。
• 合計が一致しないことがあります。 その場合は隠さず報告します。古い決議では異なる基準で合計が記載されており（FY1994では数百億ドルの差があります）、FY2022の決議のうち1件では、本文中の数値に50億ドルの差があります。reconciliation.years[].matchesを参照してください。
• 1994年より前の会計年度はデータソースの対象外であるため、before_coverageを返します。

クイックスタート

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

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

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

https://gateway.pipeworx.io/budget-resolutions/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 も同じゲートウェイと同じ 1858 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx ですべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/budget_resolution_find \
  -H 'Content-Type: application/json' \
  -d '{"fiscal_year":2025}'

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

npm から実行する

@pipeworx/mcp-budget-resolutions は Pipeworx ゲートウェイに接続するローカルの stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを上記と同じ https://gateway.pipeworx.io/budget-resolutions/mcp エンドポイントに転送します。ネットワークアクセスが必要です。オフラインモードはありません。

{
  "mcpServers": {
    "budget-resolutions": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-budget-resolutions"]
    }
  }
}

キーがない場合は匿名で呼び出し、1 日あたり 50 回に制限されます。無料アカウントを作成すると、1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーエントリに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーはホスト型接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそちらとまったく同じように計測され、課金されます。

デフォルトでは、このパックのツールのみが一覧表示されます。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx やその他のゲートウェイ全体で使えるツールも一覧表示されます。

HTTPS プロキシ経由の場合、Node の組み込み fetch はデフォルトでは HTTPS_PROXY を読み取りません。新しい Node リリースでは NODE_USE_ENV_PROXY=1 を設定すると利用できます。お使いの Node バージョンのドキュメントを確認してください。

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Budget Resolutions data" })

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

詳細

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

ライセンス

MIT