Ny Authority Debt

ny-authority-debt

纽约公共机构债务发行情况——由哪个机构借款、用于什么项目、条款如何，以及发行时间。数据来源于纽约州在 data.ny.gov 上发布的四个 Authorities Budget Office 数据集。无需密钥。

Pipeworx 的一部分：Pipeworx——一个将 AI agents 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	可回答的问题
ny_authority_debt_search	纽约发行了哪些债券——按机构、项目、规模、日期或税务状态筛选？
ny_authority_debt_profile	某个机构发行的所有债券，以及按年份和新资金发行与再融资分类的总额。
ny_authority_debt_totals	按年份和机构类别汇总的借款情况；发行规模最大的机构。
ny_authority_debt_coverage	覆盖哪些内容、数据最早追溯到何时，以及明确说明哪些内容不在此处。

覆盖范围

四类机构，约 4,470 条报告记录：

类别	数据集	行数
州级机构	83xh-6x8i	1,617
地方机构	qbd7-9grw	814
工业发展机构	cci8-aavx	632
地方发展公司	sh2f-cc7d	1,410

每行代表某个机构在某个财政年度的报告。issued_debt_obligations 为 N 的行表示该机构当年没有发行任何债务——这些工具会筛选出值为 Y 的行，因此机构发行清淡的年份绝不会看起来像是发行记录缺失字段。

本项目不包含的内容

• 没有二级市场交易价格。 这里记录的是一级发行：售出了什么，以及条款如何。此外，大多数市政债券交易频率很低，根本没有当前市场价格——供应商提供的市政债券“价格”通常是估值价格，也就是估算值，而非实际交易价格。如果调用方误以为情况并非如此，就会把没有记录理解为“没有发生交易”。
• 没有 CUSIP。 见下文。
• 仅覆盖纽约州。 加利福尼亚州由 ca-debtwatch 覆盖。要识别任何地区的单只债券，请使用 openfigi_search，并设置 marketSecDes: "Muni"。

影响代码设计的两项限制

有意移除 CUSIP。 State Authorities 数据集包含 cusip_number 列，其中 1,295 行填有真实的 9 字符 CUSIP。CUSIP 标识符由 CUSIP Global Services 授权许可，而具有约束力的是该许可，而非底层事实的版权。该列在返回任何内容前都会被剔除，没有 CUSIP 筛选器，也不会存储任何 CUSIP。此处请使用发行方名称作为查询依据；要查询单只债券，请通过 openfigi 使用 FIGI。不要重新添加 CUSIP。

仅提供 EMMA 链接，从不抓取。 MSRB 的条款是使用 EMMA 即表示接受的合同条款，并禁止从其内容构建数据库。此数据包返回的 official_statement_url 是纽约州自行发布的链接——通常指向托管在 emma.msrb.org 上的 PDF，有时指向机构自有网站——该链接会直接传递，不会发出请求或进行解析。emma_search_url 是一个组合生成的搜索链接，其名称准确说明了它的用途：该路径会返回 200，但页面由脚本驱动，我们有意不解析，因此搜索内容可能不会预先填入。

数据来源

• New York State Open Data — https://data.ny.gov（Authorities Budget Office 债务发行报告）

注意：Socrata 目录搜索会跨州联合查询

查询其他州的 Socrata 目录（例如 data.texas.gov）时，会返回这些相同的数据集 ID，因为目录 API 会跨州联合查询。德克萨斯州并未发布这些数据集。将数据集归属于某州之前，务必检查目录搜索结果中的 metadata.domain——已于 2026-09-01 验证，四个数据集的 domain: data.ny.gov。

快速开始

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

{
  "mcpServers": {
    "ny-authority-debt": {
      "url": "https://gateway.pipeworx.io/ny-authority-debt/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ny-authority-debt/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/ny_authority_debt_search \
  -H 'Content-Type: application/json' \
  -d '{"authority":"Dormitory","min_amount":100000000,"limit":3}'

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

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

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

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

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

npx -y @pipeworx/mcp-ny-authority-debt

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Ny Authority Debt data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT