Treasury Fiscal

美国财政部财政数据

美国财政部的财政数据 API。提供每日财政部现金状况、未偿公共债务、联邦收入与支出、海关收入、汇率和储蓄债券赎回数据。这些就是“联邦赤字”和“国债”的实际数字。免费，无需身份验证。

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

为什么这对 AI Agent 很重要

对于有关美国财政立场的宏观问题——债务水平、每日现金状况、月度收入、海关收入——Treasury Fiscal Data 是权威的实时数据源。FRED 发布月度汇总数据，而 Treasury 发布底层的每日账目。

常见工作流：

• 国债。“当前公共债务是多少？”→ treasury_debt → 未偿债务总额，并细分为政府内部持有和公众持有。
• 海关收入。“2024 年 Treasury 收取了多少关税收入？”→ treasury_customs_revenue({year: 2024})。
• **收入 / 支出。**按来源列出的每日 Treasury 现金状况（存款与取款）。
• **汇率。**Treasury 对外币交易公布的报告汇率（联邦承包商和补助金受领方使用）。
• 拍卖结果。“最近一次 10 年期票据拍卖的最高收益率是多少？”→ treasury_auction_results({security_type: "Note", term: "10-Year"}) → 最近一次已结算拍卖的最高收益率、投标覆盖率、CUSIP、发行金额 / 获配金额。涵盖国库券、票据、债券、TIPS 和浮动利率票据（FRN）。

供 trade_bilateral_analysis 复合工具用于关税背景分析。

身份验证

无需验证。Treasury Fiscal Data 完全公开、免费，无需密钥。

值得了解的数据集

数据集	更新频率	用途
每日 Treasury 报表	每日	现金状况、存款、取款
月度 Treasury 报表	每月	收入、支出、赤字
未偿公共债务	每日	债务总额、政府内部持有与公众持有
海关收入	每月	关税收入
Treasury 报告汇率	每季度	联邦会计使用的官方汇率
储蓄债券证券	每月	发行、赎回
拍卖	每场拍卖（约每日）	国库券 / 票据 / 债券 / TIPS / FRN 的最高收益率 / 利率、投标覆盖率、CUSIP

更新频率

• 每日 Treasury 报表：美国东部时间下午约 3 点，T+1（下一个工作日）
• 月度报表：月中左右发布，涵盖上月数据
• 公共债务：每日
• 汇率：每季度（重新校准；并非实时市场汇率——实时汇率请使用 FX / 外汇工具包）

Pipeworx 使用与这些频率相匹配的 TTL 缓存。

常见误区

• 公众持有债务与总债务。“公众持有债务”不包括政府内部持有的债务（社会保障信托基金等）。新闻标题通常引用总债务；分析人士关注的是公众持有债务。数据中包含两者。
• **海关收入 ≠ 仅关税。**其中包括反倾销税、反补贴税和费用。要获取纯关税收入，请在调用响应中按项目代码筛选。
• **财政部汇率并非市场汇率。**这些汇率每季度重新校准，用于联邦会计。要获取实时外汇汇率，请使用专用的 exchange-rate 或 frankfurter 工具包。
• **每日现金头寸不是 GDP。**财政部的现金头寸是存量指标；GDP 是流量指标。请勿混淆。
• **财政年度与日历年度。**联邦财政年度为 10 月 1 日至 9 月 30 日。收入和支出默认按财政年度报告。如需日历年度数据，请明确筛选。
• **拍卖通常是续发行，而非新发行。**财政部会以剩余期限较短的方式续发行现有票据／债券 CUSIP（例如，一张发行 2 个月后拍卖的“10 年期票据”会显示为“9 年 10 个月”期限）。treasury_auction_results 的 term 筛选条件匹配证券的原始名义期限（响应中的 original_term），因此“10-Year”仍能找到它——请使用 term／响应中的 original_term，判断是新发行还是续发行。
• **源数据中，TIPS 和 FRN 并不属于独立的 security_type。**财政部将它们归为 Note／Bond，并附带通胀指数化或浮动利率标志。传入 security_type: "TIPS" 或 "FRN"，工具会为你解析；原始 API 自带的 security_type:eq:TIPS 筛选条件会返回零行。
• **国库券报告的是利率，而非收益率。**国库券的 high_yield_pct 为空——请使用 high_investment_rate_pct（债券等价收益率）或 high_discount_rate_pct（实际投标的贴现率）。

快速开始

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

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

此端点实际提供的内容

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

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

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

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/treasury_customs_revenue。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

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

npx -y @pipeworx/mcp-treasury-fiscal

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize／tools/list／tools/call，仅提供此工具包的工具——不含上述网关连接额外添加的共享元工具。数据源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Treasury Fiscal data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT