Ucc Liens

@pipeworx/ucc-liens

企業債務者のUCC（統一商事法典）融資担保権届出情報 — 企業資産を担保とするローン — をコロラド州、コネチカット州、オレゴン州について提供し、最近の届出に基づく貸し手の活動シグナルも提供します。各州の独自の公開データを提供する州務長官ポータルを情報源としています。バーモント州は到達不能として記載されています（「データソース」を参照）。個人債務者は検索時点で除外され、検索後にフィルタリングされることはありません。また、すべてのレスポンスにFCRAに関する通知が含まれます。

Pipeworx の一部です — AI エージェントを1745以上の稼働中データソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

ツール

• ucc_search(debtor_name, state, limit?) — CO、CT、ORで企業債務者名により届出を検索します。届出ごとに、ファイル番号、届出の種類／ステータス、届出日と失効日、債務者の名前／住所、担保権者の名前／住所、情報源URLを返します。state: "VT" は常にエラーになります（「データソース」を参照）。
• ucc_new_filings(state, since, secured_party?, limit?) — 日付以降の最近の届出を返し、貸し手の活動シグナル（誰が誰に、いつ貸しているか）を提供します。対象州は同じです。担保権者名の部分一致による任意のフィルターを指定できます。

認証

キーは不要です。3つの稼働中の情報源はいずれも、認証なしで利用できる公開オープンデータAPIです。

データソース

• https://data.ct.gov/resource/xfev-8smz.json — コネチカット州務長官、「統一商事法典（UCC）担保権設定届出」。担保権設定取引（当初届出、修正、継続、解除）ごとに1行あります。事業者の債務者には 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データで、3つの独立したSocrataデータセットをメモリ内で fileid によって結合します（サーバー側の結合はありません）。債務者について、事業者の場合は organizationname、個人の場合は firstname／lastname が登録されています。このパックはまず債務者データセットを organizationname IS NOT NULL で検索し、検索で返された fileid の届出／担保権者のみを取得します。4つ目のデータセット 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 の行を2回目のクエリで取得します。過去およそ1か月に届出がない債務者は、担保権が有効なままでも表示されません。これは実際の対象範囲の制限であり、バグではありません。すべてのオレゴン州の届出の coverage_note フィールドに記載されています。 オレゴン州の全履歴検索（secure.sos.state.or.us/ucc/searchHome.action → POST /ucc/search.action）は、v1では使用していませんが、アクセスは可能です — 本番アカウントの使い捨てCloudflare Workerからライブでエッジプローブを実施（2026-10-08）：検索フォームにGETして CSRFToken とセッションCookieを取得後、債務者検索をPOSTすると、クリーンな「Welcome Public User」検索結果ページが返されました（債務者NIKEで有効な担保権2件を確認）。ボットチャレンジはなく、3回の試行すべて成功しました。それでも使用しないのは、結果の一覧に担保権者の列がないためです。担保権者を取得するには行ごとに届出詳細ページを追加で取得する必要がありますが、snfi-f79b なら1回の追加クエリで無料で取得できます。別途、一般的な住宅／オフィスのクライアント（Workerではない）からはAkamaiのボット対策に阻まれます：同じノートPCから連続して実行した3回の curl プローブでは、最初のリクエストでクリーンなHTMLが返された一方、それ以降はすべてAkamaiの難読化されたJSセンサーチャレンジページ（window["bobcmn"] = "..."）が返されました。「自分のノートPCからテストした」ことが、このホストについてどちらの方向の判断材料にもなるとは限りません。ここでは両方の結果があり（Worker：問題なし、Worker以外のクライアントで繰り返すと遮断）、どちらの結果を当てにする場合も、必ずWorkerから再プローブしてください。
• バーモント州には自動化可能な情報源がありません。 公開されている唯一のUCC検索 bizfilings.vermont.gov/uccsearch（Angular SPAで、"Lien Records Search"として api.bizfilings.vermont.gov/api を呼び出します）では、検索リクエストが送信される前に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 サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの 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