Sec Nmfp

@pipeworx/sec-nmfp

美国货币市场基金投资组合持仓数据，来源于 SEC Form N-MFP。无需密钥。

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

工具

• nmfp_security_holders(issuer, period?, limit?) — 查询持有某发行方票据的货币市场基金。接受发行方名称片段或 CUSIP。
• nmfp_fund_holdings(fund, period?, limit?) — 查询某只基金一个月的申报投资组合，并提供每个类别的持仓数量。
• nmfp_periods() — 查询 SEC 已发布的月度报告期（目前为 50 个）及每期涵盖的日期范围。

反向查询正是这个工具包的意义所在

SEC 以申报为先的方式发布 N-MFP：每只基金每月提交一份申报，投资组合信息包含在其中。因此，“这只基金持有什么”是自然的问题，而*“哪些基金持有这个发行方的票据”*则不是——要回答后者，必须读取该报告期内的每份申报。nmfp_security_holders 每次调用都会完成这项工作，这正是这个工具包存在的意义。当银行或发行方出现动荡时，人们会想知道谁受到影响，而没有任何一份申报能回答这个问题。

以 2026-07-09→2026-08-07 期间为例：341 份基金申报，47,129 项持仓。仅 Federal Home Loan Bank 就出现在 129 只基金的 6,489 项持仓中。

响应中揭示的解读陷阱

• 持仓数量是计数，不是金额。 这里不包含 N-MFP 持仓价值，因此 positions_by_category 表示每个类别有多少项持仓，而非金额。一只基金如果持有许多小额回购头寸和一大笔国债头寸，按数量看会显得以回购为主，但按价值看未必如此。两个工具都会在 reading_note 中说明这一点。
• 只有货币市场基金才提交 N-MFP。 债券基金或股票基金无论规模多大，都不会出现在其中。found: false 路径会明确说明这一点，而不是暗示该基金什么都没持有。
• 发行方名称沿用基金填写的内容 — FEDERAL HOME LOAN BANK SYSTEM，而非规范化的实体名称。匹配方式为子字符串匹配；未匹配时会提示调用方缩短名称片段，而非断定没有基金持有该发行方的票据。

结构

每个月度期间对应一个 ZIP，约 11.9MB，包含 23 个 TSV 文件。读取其中三个：NMFP_SUBMISSION（基金及其申报）、NMFP_SERIESLEVELINFO、NMFP_SCHPORTFOLIOSECURITIES（持仓）。其余文件均跳过——包括 NMFP_COLLATERALISSUERS，该文件原始大小单独就有 55MB，是其余整个压缩包的五倍，而且无法回答这里要解决的问题。

每次调用时实时读取，而非保存在镜像中：一个期间只需获取一次数据，而货币市场相关问题几乎总是针对最近一个月。

有两项文件格式说明值得牢记，因为这两点都曾耗费本代码库不少时间：

• 文件大小取自 ZIP 中央目录，而非本地文件头。SEC 会在某些数据集中设置数据描述符标志，使本地文件头中的大小变为零；依赖这些大小的读取器将无法提取任何内容。
• 文件名包含日期范围（20260709-20260807_nmfp.zip），无法通过计算得出——这些周期与日历月并不一致，每个周期都会变化。这是这里第四个采用自有路径规则的 SEC 数据集，因此会读取索引页，而不会自行构造 URL。

发布频率

货币市场基金每月提交申报；SEC 会在报告期结束几天后发布数据。

来源

SEC Form N-MFP 数据集 — https://www.sec.gov/data-research/sec-markets-data/dera-form-n-mfp-data-sets

快速开始

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

{
  "mcpServers": {
    "sec-nmfp": {
      "url": "https://gateway.pipeworx.io/sec-nmfp/mcp"
    }
  }
}

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/nmfp_security_holders \
  -H 'Content-Type: application/json' \
  -d '{"issuer":"Federal Home Loan Bank","limit":10}'

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

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

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

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

或者直接运行它，确认服务可以启动：

npx -y @pipeworx/mcp-sec-nmfp

它通过 stdin/stdout 使用 MCP 通信，并且只针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接额外提供的共享元工具。使用相同的源代码和工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Sec Nmfp data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT