Ucc Liens

@pipeworx/ucc-liens

企业债务人 UCC（统一商法典）融资声明备案——以公司资产作担保的贷款——覆盖科罗拉多州、康涅狄格州和俄勒冈州，并提供近期备案的贷款方活动信号。数据来自各州自己的州务卿公开数据门户；佛蒙特州的数据源已记录为无法访问（参见“数据来源”）。在查询时即排除个人债务人，而不是在查询后再筛除；每个响应均附带 FCRA 声明。

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

工具

• ucc_search(debtor_name, state, limit?) — 按企业债务人名称搜索 CO、CT 或 OR 的备案记录。返回每条备案的档案编号、备案类型/状态、备案和失效日期、债务人名称/地址、担保权人名称/地址，以及来源 URL。state: "VT" 始终会抛出错误（参见“数据来源”）。
• ucc_new_filings(state, since, secured_party?, limit?) — 查询指定日期以来的近期备案，用于获取贷款方活动信号（谁在向谁放贷，以及何时放贷）。覆盖相同的州；可选按担保权人名称进行子字符串筛选。

身份验证

无需密钥。全部三个实时数据源均为公开、无需身份验证的开放数据 API。

数据来源

• https://data.ct.gov/resource/xfev-8smz.json — 康涅狄格州州务卿，“统一商法典（UCC）留置权备案”。每行对应一笔留置权交易（原始备案、修订、续期、解除）。企业债务人使用 debtor_nm_bus 字段；个人债务人则使用 debtor_nm_last/debtor_nm_first 字段，不会使用 debtor_nm_bus——该套件的 $where 要求 debtor_nm_bus IS NOT NULL，因此不会获取个人债务人记录。此数据集未公布抵押物描述字段。
• https://data.colorado.gov/resource/wffy-3uut.json（备案）， https://data.colorado.gov/resource/8upq-58vz.json（债务人）， https://data.colorado.gov/resource/ap62-sav4.json（担保权人）— 科罗拉多州州务卿的 UCC 数据，分为三个独立的 Socrata 数据集，并在内存中按 fileid 联接（服务端不支持联接）。企业债务人使用 organizationname 字段，个人债务人使用 firstname/lastname 字段——该套件先在债务人数据集中查询 organizationname IS NOT NULL，之后只会获取搜索结果返回的 fileid 对应的备案/担保权人记录。还有第四个数据集 4am6-w6u4（抵押物），但 v1 不查询该数据集，以控制响应大小——如果调用方需要，添加这个结构简单的数据集即可。
• https://data.oregon.gov/resource/snfi-f79b.json — 俄勒冈州州务卿，“上月录入的 UCC 备案清单”。这是滚动的约 30 天窗口，而非完整历史索引——数据集名称就是字面含义；它每月替换，而非不断累积。party_type 为 DB（债务人）或 SP（担保权人）；entity_type 为 ORG 或 IND。该套件在搜索/新备案查询中要求 party_type = 'DB' AND entity_type = 'ORG'，然后按 original_file_number 再次查询匹配的 SP 记录，以附加担保权人信息。即使某项留置权仍有效，若债务人在大约上个月没有备案记录，也不会出现在结果中——这是真实的覆盖限制，并非错误，俄勒冈州每条备案的 coverage_note 字段都有说明。 俄勒冈州完整历史查询（secure.sos.state.or.us/ucc/searchHome.action → POST /ucc/search.action）v1 中未使用，但可以访问——已于 2026-10-08 通过生产账户中的临时 Cloudflare Worker 实时探测：获取搜索表单以取得 CSRFToken 和会话 Cookie，然后 POST 债务人搜索请求，便会返回正常的“Welcome Public User”结果页（已通过债务人 NIKE 验证，有 2 条有效留置权），无机器人验证挑战，3 次运行均成功。尽管如此，仍未采用该方式，因为结果列表没有担保权人列——要获取担保权人信息，就必须为每行额外请求一次备案详情页；而 snfi-f79b 只需一次额外查询便可免费提供这些信息。另外，从普通住宅/办公网络客户端（而非 Worker）访问时，确实会遇到 Akamai 机器人墙：同一台笔记本连续 3 次 curl 探测，首次请求返回正常 HTML，之后每次重试都会返回 Akamai 混淆过的 JS 传感器验证页面（window["bobcmn"] = "..."）。不要以为“我在笔记本上测试过”就能说明这个主机的情况——这里两个方向都成立（Worker：正常；非 Worker 客户端重复请求：被拦截）——在依赖任一结论前，务必先通过 Worker 重新探测。
• 佛蒙特州没有可自动化的数据源。 该州唯一公开的 UCC 搜索 bizfilings.vermont.gov/uccsearch（“留置权记录搜索”，一个调用 api.bizfilings.vermont.gov/api 的 Angular SPA），要求先完成 Google reCAPTCHA，之后才会发送搜索请求——已于 2026-10-08 通过真实浏览器会话实时确认：提交表单后弹出“User validation required to continue”/“I'm not a robot”对话框，网络跟踪显示 google.com/recaptcha/api2/anchor 和 /bframe 调用会阻止 POST 请求。佛蒙特州没有 UCC 备案的开放数据镜像（已检查 data.vermont.gov / 开放数据搜索）。使用 state: "VT" 调用 ucc_search/ucc_new_filings 时，总是会抛出清晰说明此限制的错误——这是有意设计的，绝不会静默返回空结果，也绝不会自动尝试（无论是否可行，绕过 CAPTCHA 都不在允许范围内）。 合规性：每个工具描述和每个成功响应都包含 fcra_notice："Not a consumer report. Not for use in credit, employment, insurance or housing eligibility decisions (FCRA)." 这是公共备案查询服务， 不是信用机构产品。

快速开始

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

{
  "mcpServers": {
    "ucc-liens": {
      "url": "https://gateway.pipeworx.io/ucc-liens/mcp"
    }
  }
}

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ucc_search \
  -H 'Content-Type: application/json' \
  -d '{"debtor_name":"NPG Holdings","state":"CT"}'

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

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

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

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

或者直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-ucc-liens

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

与 ask_pipeworx 配合使用

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

ask_pipeworx({ question: "your question about Ucc Liens data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT