Ca Debtwatch

@pipeworx/ca-debtwatch

加利福尼亚州市政债券发行数据——自 1984 年以来，向加利福尼亚州债务与投资咨询委员会（CDIAC）报告的所有州和地方政府债券、票据、参与证书及 Mello-Roos 特别税交易，按发行逐笔提供本金、销售日期、债务类型、用途、评级、利息成本、发行费用，以及该交易的承销商、市政顾问和债券法律顾问。

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

这是一级市场发行数据，不是二级市场交易记录。它不包含 MSRB/EMMA 内容，也不依赖 CUSIP——CDIAC 将其作为加利福尼亚州公共数据发布。

工具

• ca_debt_search_issues(...) — 按发行方、县、债务类型、用途、税务状态、ESG 标签、销售日期和本金金额搜索 76,000+ 笔加利福尼亚州发行。最常用的工具。
• ca_debt_issue(cdiac_number) — 查看单笔发行的完整详情，包括按参与方分类的发行成本（承销商承销折扣、顾问费、债券法律顾问费和信息披露法律顾问费、受托人费、评级机构费），以及之后年度提交的相关年度债务透明度报告（ADTR）条目。
• ca_debt_issuer_profile(issuer) — 查看单个发行方的借款历史：本金总额、发行数量、日期范围、按债务类型和用途划分的明细，以及规模最大和最近的发行。
• ca_debt_statewide_totals() — 查看州财政部长公布的核心总额（年初至今的债务发行额、年初至今的地方债务发行额、已提议但尚未售出的债券、近期长期债券发行量）。
• ca_debt_filter_options(field?) — 查看 CDIAC 对各枚举筛选条件使用的确切表述。
• ca_debt_resolve_issuer(name) — 将部分名称映射为 CDIAC 使用的确切发行方名称。

身份验证

无需密钥。无需注册或密钥，也未公布配额。

数据源

• https://debtwatch.treasurer.ca.gov/env.json — SPA 自身读取的 API 基础地址。每个隔离实例解析一次，而不是硬编码，并提供当前值作为回退。
• PUT /api/dataset/issues/search — 发行搜索。使用 PUT，而非 GET 或 POST。
• GET /api/dataset/issues — 列元数据，包括每个枚举筛选条件可接受的值。
• GET /api/dataset/issues/element/Issuer/search?q=&pageNumber=N — 发行方自动补全（7,600+ 个发行方）。每页固定返回 10 条，并忽略所有每页数量参数（pageSize、take、limit 均无效），但会在 totalValues 中报告实际总数；只有 pageNumber 有效。仅读取第一页时，搜索“san diego”会显示只有 10 个发行方，实际却有 47 个；而排序后位于后续页面的精确名称（San Diego Unified Port District）会被误判为有歧义，候选结果中也不包含该名称。此工具包会分页查询，并设置查询上限；若提前停止，也会予以说明。
• GET /api/report/issuance-detail-with-history/{cdiacNumber} — 单笔发行详情及之后提交的 ADTR 文件。
• GET /api/fast-stat — 州级核心总额。

使用之前值得了解的事项

• 格式错误的筛选条件会返回空白的 HTTP 500，而不是 400。 没有响应正文，也没有验证消息。筛选条件以列 ID 为键，并带有 type 判别字段，解码自 SPA 包： StringOneOf / StringContainsOneOf（options: []）、DateBetween / DateOnOrAfter / DateOnOrBefore / DateEqualTo（minimum / maximum / exactly）、NumberBetween / NumberGreaterThanOrEqualTo / NumberLessThanOrEqualTo、BooleanEqualTo（exactly）。其他任何值都会导致 500。
• IssuerCounty 是多值列，需要使用 StringContainsOneOf；对其发送 StringOneOf 不会报错，但不会匹配到任何内容。
• 文本筛选会严格匹配 CDIAC 的拼写，略有出入时会正常返回零行的 200，而不是错误——Los Angeles 和 Los Angeles Unified School District 是不同的发行方。此工具包中的每个枚举参数都会先与上游自身的选项列表匹配，每个发行方参数则会先通过类型提示端点解析，因此调用方即使按日常说法命名，也能获取结果。无法解析的参数会返回候选项，而不会被丢弃。
• 每个筛选条件都没有单独的 values 端点。 对于筛选策略为 AllAtOnce 的列，选项列表内嵌在 GET /api/dataset/issues 的 columns[].filter.values.all 中。高基数列使用 ByAsyncSearchOnly，只能通过 element/{col}/search 类型提示接口查询。
• SaleDate 包含拟发行债券的未来日期，因此按降序排序会显示尚未发生的交易。sold_status 可将其区分开来。
• 范围仅限加利福尼亚州。免费途径没有全国性等效数据——MSRB/EMMA 的条款禁止据此构建可再分发的数据库。

快速开始

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

{
  "mcpServers": {
    "ca-debtwatch": {
      "url": "https://gateway.pipeworx.io/ca-debtwatch/mcp"
    }
  }
}

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ca_debt_search_issues \
  -H 'Content-Type: application/json' \
  -d '{"issuer":"Los Angeles Unified School District","limit":5}'

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

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

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

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

也可以直接运行，确认服务能否启动：

npx -y @pipeworx/mcp-ca-debtwatch

它通过 stdin/stdout 使用 MCP，并针对仅此工具包自身的工具响应 initialize / tools/list / tools/call——不包含上述网关连接附加的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Ca Debtwatch data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT