Budget Resolutions

@pipeworx/budget-resolutions

按预算职能和财政年度列出国会预算决议目标（关于预算的两院共同决议，H.Con.Res. / S.Con.Res.），并附上同年度美国财政部的实际数据。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1858+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关，也未经其认可或发布。

工具

• budget_resolution_find(fiscal_year) - 查询某一财政年度有哪些预算决议，以及各自的进展：由两院通过、由一院通过，或仅提出。没有决议的年份会返回 found:false 和一个明确的 reason_code（no_resolution_exists、no_adopted_resolution、before_coverage），而非空列表。
• budget_resolution_targets(fiscal_year, function?, target_year?, adopted_only?, package_id?) - 查询决议设定的金额：收入、新预算权限、支出、赤字和债务，以及各项预算职能（国防、卫生、Medicare、净利息等）在预算年度和决议涵盖的后续年份的预算权限与支出。返回已通过的决议；若没有决议获通过，则返回已由一院通过、进展最深入的提案，并明确标记为 adopted:false。每个响应都包含一个 reconciliation 区块：按年份汇总各项职能数据，并与决议所列总额并列展示。
• budget_vs_actual(fiscal_year, function?, adopted_only?) - 并列展示目标与财政部实际收入、支出、推算赤字及各项职能支出：预算、实际值、差额、百分比。没有决议的年份仍会返回实际数据，并为缺少预算数据提供明确原因。尚未结束的财政年度会标记为 comparable:false。

身份验证

使用平台密钥（PLATFORM_DATAGOV_KEY，即 govinfo 和 congress 包已使用的 data.gov 密钥），也可通过 _apiKey 使用自带密钥。

数据来源

• 美国国会发布的关于预算的两院共同决议，来源为美国政府出版局（国会法案）。法案文本始于第 103 届国会（1993 年），因此最早涵盖的预算年度为 1994 财年。
• 美国财政部《月度财政部声明》（按预算职能列出的支出；预算内和预算外总额）。

美国联邦公共领域数据。不存储任何内容：每次调用都会读取决议文本并进行解析。

后续维护者可能会再次发现的事项

• 预算内口径。 决议中的收入、支出和职能金额不包括社会保障的预算外部分。因此，budget_vs_actual 会将总额与财政部的预算内总额进行比较（并列返回统一口径总额供参考），且会将社会保障职能（650）标记为不可直接比较。
• 预留款和节支占位项（职能 920、930）包含在决议中，但财政部没有对应项目。这些项目会附注返回，不会被丢弃；这也是决议支出总额可能远低于实际支出的原因。
• 状态根据法案文本的版本代码判定：enr 表示由两院通过；由众议院提出、送交参议院的决议（pcs、rfs、eh）仅由众议院通过。因此，未获参议院通过的众议院方案会标记为 adopted:false。
• 已登记文本副本的元数据标题有时会是另一项决议的标题。 系统按决议系列匹配，并要求解析出的文本必须以请求的财政年度开头，否则调用会被拒绝（text_year_mismatch）。
• 总额有时无法相加吻合，系统会报告这一情况，而不是隐瞒：较早的决议采用不同口径列出总额（FY1994 相差数百亿美元），且 FY2022 的一项决议自身文本中的金额相差 50 亿美元。参见 reconciliation.years[].matches。
• 1994 年之前的财政年度早于数据源的覆盖范围，会返回 before_coverage。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/budget-resolutions/mcp 返回上表中的工具，以及 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"]
    }
  }
}

不使用密钥时，它会匿名调用，每天最多 50 次。免费账号可将每日调用额度提升至 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