Ofr Funding

@pipeworx/ofr-funding

美国财政部金融研究办公室（OFR）短期融资监测 API——提供美国回购市场按抵押品和期限划分的利率／成交量（DVP、GCF、三方回购），以及货币市场基金资产负债表构成；这两类数据均未收录于 FRED 或纽约联储交易台自行发布的数据中。

隶属于 Pipeworx——一个将 AI Agent 接入 1683+ 个实时数据源的 MCP 网关。

工具

• ofr_repo_rates(collateral, tenor, measure, vintage, start_date, end_date, limit) — 查询单个抵押品类别（dvp/gcf/tri/tri_ex_fed）× 期限（隔夜／定期区间／抵押品类型细分）× 指标（利率／成交量／未偿余额）的回购利率或成交量。
• ofr_mmf_holdings(category, start_date, end_date, limit) — 查询货币市场基金每月投资构成（按抵押品／交易对手类型划分的回购、直接持有的美国国债／机构债券、银行相关资产）。
• ofr_search_funding_series(query, dataset, limit) — 在完整的 206 个回购 + 货币市场基金序列目录中按名称／助记码查找（OFR 没有实时搜索端点）。
• ofr_funding_anomaly(mnemonic OR collateral/tenor/measure/vintage, window_days) — 将最新观测值与过去一段时间进行比较，并报告变化值 + z 分数，同时说明所用的确切时间窗口。

身份验证

无需密钥。无需注册、API 密钥；未发现速率限制标头。

数据源

• https://data.financialresearch.gov/v1/series/timeseries?mnemonic=... — 唯一的实时单次查询路由。针对单个助记码返回原始 [[date, value], ...] 数组。四个工具返回的每个实际数据点均通过此端点获取。
• https://data.financialresearch.gov/v1/series/dataset?dataset=repo 和 ?dataset=mmf — 批量元数据 + 数据转储（gzip 后约 9MB；货币市场基金数据约 450KB），仅用于一次（2026-09-23）生成 src/catalog.ts（助记码 → 人类可读名称 → 起始日期 → 频率）。请求时绝不会调用；数据量过大，不适合在 Worker 中逐次调用获取，而且若这样做就会成为批量镜像。本套件返回的实际数值始终来自上述 timeseries 端点，按请求实时获取。
• https://www.financialresearch.gov/short-term-funding-monitor/ — 这些 API 所支撑的面向用户的网站。

注意事项

• /v1/series/search、/v1/series/metadata、/v1/metadata/series、/v1/series/datasets 均返回 403 {"message":"Missing Authentication Token"}。 这是 API Gateway 对未定义路由的标准响应，并不表示实际需要身份验证——根本没有公开的发现／搜索端点。因此，ofr_search_funding_series 使用静态生成的查找表，而非实时搜索调用。
• 助记码格式：回购数据采用 REPO-{COLLATERAL}_{MEASURE}_{TENOR}-{VINTAGE}，货币市场基金数据采用 MMF-{...}-M。并非每种抵押品／期限／指标组合都存在——例如，DVP 没有美国国债／机构债券／公司债券抵押品类型细分，只有 GCF／TRI 有。无效组合会导致上游返回状态码 400，响应正文为 Invalid mnemonic；ofr_repo_rates 会提供指向 ofr_search_funding_series 的提示，而不会在客户端猜测组合是否有效。
• 数据版本很重要：OFR 会先发布 preliminary 值，几天后再发布 final 修订版，两者使用不同的助记码后缀（-P 和 -F），而非原位更新。默认使用 preliminary 可获取最新数值；对于超过几天的数据，final 更准确。
• 发布延迟：最新的回购利率观测值通常比当天晚 1-2 个日历日（例如，2026-09-23 查询时，最新的三方隔夜利率日期为 2026-09-21）——这是正常的发布延迟，并非服务中断。
• ofr_funding_anomaly 的 z 分数由本套件计算，并非 OFR 发布的统计值——计算时会将最新数据点排除在自身的回溯窗口之外，因此窗口与待评估数据点不会重叠。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/ofr-funding/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 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ofr_repo_rates \
  -H 'Content-Type: application/json' \
  -d '{"collateral":"tri","tenor":"overnight","measure":"rate"}'

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

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

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

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

或者直接运行以确认它能启动：

npx -y @pipeworx/mcp-ofr-funding

它通过 stdin/stdout 使用 MCP，并针对仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接所添加的任何共享元工具。使用相同的源代码和工具，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——此功能既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ofr Funding data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT