Usaspending

USAspending — 联邦合同与拨款奖项

美国财政部的 USAspending.gov 联邦奖项数据：合同、拨款、贷款和直接付款。涵盖联邦政府自 2008 年以来授予的每一笔资金（追溯到 2001 年的数据覆盖较零散），并按受款方、机构、下属机构、NAICS 代码和履约地点细分。免费，无需身份验证。

属于 Pipeworx — 一个将 AI Agent 接入 1815+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

这对 AI Agent 有何意义

SAM.gov 展示的是采购机会（政府要买什么），而 USAspending 展示的是已授予的奖项（实际签订了哪些合同）。对于竞争情报、游说支出 ROI 分析、联邦供应商研究，或追踪政策领域的资金流向来说，这是权威数据源。

常见工作流：

• “X 收到了多少联邦合同资金？” → get_federal_spending({recipient: "X"}) → 按年份和机构统计的奖项总额。
• “DoD 的头部承包商有哪些？” → 按机构筛选支出搜索。
• “联邦政府在 AI／网络安全／清洁能源领域的投资有多少？” → 关键词 + NAICS／PSC 代码搜索。

govcon_contractor_profile 和 lobbying_activity 配方会用到这些数据。

身份验证

无需身份验证。USAspending 完全公开且免费。

奖项类别

类别	内容
合同（FPDS-NG）	直接采购；竞争性采购或单一来源采购
拨款	酌情拨款或公式拨款（研究、州级拨款）
贷款	联邦信贷计划（SBA、USDA、Education）
直接付款	Social Security、退伍军人福利等
IDV（不定期交付合同）	主合同；通过订单执行

对于公司层面的分析，合同通常最重要。对于大学和非营利组织，拨款则很重要。

常见问题

• 受款方名称标准化。 数据中可能出现 “Lockheed Martin Corporation”、“LOCKHEED MARTIN CORP” 和 “Lockheed Martin”。清理总额时，先移除法律实体后缀，再忽略大小写进行汇总。
• 母公司与子公司。 大型公司拥有许多子公司，每家都有独立的 UEI。USAspending 包含母公司与受款方的层级字段，可用于计算真正的公司级总额。
• 承诺金额与实际支出金额。 “承诺金额”是政府承诺支付的金额；“实际支出金额”是已经支付的金额。多年期合同的两者可能相差数年。
• “我们销售 IT 服务”对应的 NAICS 代码。 单个承包商可能有数十个 NAICS 分类。按 NAICS 筛选，只会显示按该分类归类的奖项；跨 NAICS 分析需要谨慎汇总。
• 数据延迟。 大多数奖项会在承诺后 30 天内公布。最近一个季度的数据不完整，之后还会向上修订。
• 唯一奖项 ID。 奖项有稳定的 ID（合同使用 PIID，拨款使用 FAIN）。引用时请使用这些 ID；受款方层级的总额则是汇总视图。

重新竞标日历 — usa_expiring_awards / usa_incumbent_profile

“未来 12 个月内，有哪些价值超过 $10M 的 VA IT 合同到期？当前持有方是谁？”是政府承包业务拓展的核心问题，而这两个工具可以直接回答——无需密钥，也不会受到上游限流。

usa_expiring_awards({agency: "Department of Veterans Affairs", naics: "5415",
                     min_amount: 10000000, months_ahead: 12})
usa_incumbent_profile({recipient: "Booz Allen"})

usa_expiring_awards 会返回每个奖项的现任承包商、履约期限、承诺金额、机构／下属机构、NAICS／PSC，以及 usaspending.gov 链接。 usa_incumbent_profile 会返回单个承包商的项目组合：有效奖项、承诺总额、合同上限、未来 6／12／18 个月内到期的合同、主要机构和 NAICS。

这些工具读取 usaspending_awards_current，这是一个物化视图，每个奖项一行（来自 1,510,983 笔交易的 626,306 个奖项）。每次管道加载后都要运行 select usaspending_refresh_awards_current(); 重建该视图；此操作也会更新每个响应中包含的 mirror_as_of 时间戳。

需要注意的问题

• 粒度。 基础表每笔交易占一行。每次修改都会重复记录奖项的 PIID，因此直接查询 usaspending_contracts 会将同一合同计数多次，也会将其金额重复求和。请使用视图。

• 两个不同的结束日期。 period_of_performance_current_end_date 是重新竞标的决策时间点。period_of_performance_potential_end_date 则是所有选项期都结束的时间。一项奖项将在 6 个月后结束，但选项期还剩 3 年，这意味着它会延期，而非重新竞标——将其列为潜在商机会造成假阳性，看起来与真正的商机完全一样。options_status 会报告 options_remain / no_options_remain / unknown；对于 2026-08-28 之前加载的所有数据，该值都是 unknown：数据导入时未保存潜在结束日期，该字段要等到下一次管道运行后才会开始填充。

• 结束日期取自最新交易，而不是最大值。 5,299 项奖项（0.88%）的这两个日期并不一致，因为后续修改可能会缩短履约期。与 api.usaspending.gov 核对后发现，最新交易日期有 5 次与上游数据匹配，最大日期有 1 次匹配。不要将其“修正”为 max()。

• 日期仍可能过时。 在 mirror_as_of 之后提交的修改，可能已延长此处列为即将到期的奖项——有一项 $1.4B 的 VA 奖项就因此被提前 14 个月读取。请通过 usaspending_url 查看实时信息。

• 不包括 IDV。 它们是没有履约期的订购工具，因此没有到期时间。443,315 笔交易没有结束日期，但 626,306 项奖项中只有 22,221 项没有，因为日期取自最新一笔实际带有结束日期的交易。

• min_amount 筛选的是已承付金额，而非上限。 一项上限为 $40M、实际工作金额仅为 $40k 的轻度使用工具，无法达到 $10M 的门槛。

• mirror_as_of 来源于数据，而非快照文件名。 两者曾不一致：固定快照 URL 显示 contracts-all-20260506.zip，而表中的操作日期却一直到 2026-08-04。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/usaspending/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 都连接到同一个网关和相同的 1815+ 个数据源。唯一的区别是哪些数据包的工具会被直接列出；无论连接哪个 URL，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

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

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/usa_spending_by_agency。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

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

也可以直接运行，以确认它能够启动：

npx -y @pipeworx/mcp-usaspending

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包的工具——不包含上述网关连接额外提供的任何共享元工具。相同的源代码，相同的工具，不使用 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——这既适用于上述软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Usaspending data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT