License Verify Mcp

io.github.lmaniraruta由 GitHub 账号 lmaniraruta 发布v0.1.3更新于 Oct 24, 2026

Verify US contractor license + surety bond + insurance from official state data. WA live, CA beta.

已验证STDIO仅桌面商业与电商

概览

AI 生成的概览

一个本地 MCP 服务器，让助手依据官方州级数据核验美国承包商的执照、履约保证和保险。

可以做什么
依据官方州级记录核验承包商执照状态，华盛顿州已正式上线，加利福尼亚州处于测试阶段。同时核查执照相关的履约保证与保险信息。结果来自官方州级数据源，而非普通网络搜索。
适用场景
适合在雇用或签约美国承包商之前，确认其是否持有执照、履约保证和保险，尤其适用于华盛顿州，以及可信度较低的加利福尼亚州。
运行要求
以本地进程方式运行，通过 stdio 使用 npm 包 license-verify-mcp 安装，需要 Node.js。未声明任何身份验证、环境变量或请求头。依赖官方州级数据，意味着需要网络访问。
安装前请注意
覆盖范围有限：仅华盛顿州已上线，加利福尼亚州为测试版，其他州或加州的结果可能不完整或未经核实。重要结论应回到官方州级来源再次确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 License Verify Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Contractor License + Bond + Insurance Verify (MCP, agent-payable)

The only MCP-native license check that returns official SURETY BOND + INSURANCE from state data — not just active/inactive status. Pay-per-success: $0.03 full result, $0.01 status-only, FREE on a miss. WA live (official L&I), CA beta (CSLB).

Tools: verify_license, list_supported_jurisdictions.

Quickstart

json
// Call{ "tool": "verify_license", "jurisdiction": "WA", "license_number": "ECOSTSC758NN" }
json
// Response (abridged){  "found": true,  "result": {    "status": "active",    "bonded":  { "is_bonded": true, "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Amount: $30,000" },    "insured": { "has_insurance": true, "details": "Carrier: State National Ins Co Inc; Coverage: $1,000,000" }  }}
ResultPrice
Full (status + bond + insurance)$0.03
Status-only (no bond/insurance match, or statusOnly: true)$0.01
Miss (found: false)FREE

Jurisdictions

StateStatusSourceBond + Insurance
WA✅ LiveWA L&I open data (data.wa.gov)✅ Real data (bzff-4fmt + ciwg-agsx datasets)
CA⚠️ BetaCSLB HTML (cslb.ca.gov)✅ Parsed when CSLB is up

Washington is the reliable, production-ready jurisdiction. Official WA L&I open data is served via Socrata JSON — no scraping, no rate limits, bond and insurance data included from dedicated datasets.

California is beta. CSLB does not publish an open API; the provider fetches the HTML detail page directly. CSLB rate-limits or 503s automated requests intermittently. When unavailable, verify_license returns a clean SESSION_ERROR — you are never charged on source failures. Do not rely on CA for production workflows until a stable server-side CSLB run is confirmed.

Apify Actor

Agentic-payments eligible — pay-per-event pricing + limited permissions + no Standby mode.

Pricing

EventPrice
license-verification$0.03 — full result (status + bond + insurance)
status-only-result$0.01 — status found, no bond/insurance match (or statusOnly: true)

Charged only on found: true. Validation errors, not-found results, and source failures are not charged.

Input

json
{  "jurisdiction": "WA",  "license_number": "ECOSTSC758NN"}
FieldTypeRequiredNotes
jurisdiction"WA" | "CA"✅WA = live; CA = beta
license_numberstringone of ↓WA: alphanumeric. CA: numeric, ≤8 digits
business_namestringone of ↑WA only. Partial match, may return matches[]

Output (default dataset)

json
{  "found": true,  "jurisdiction": "WA",  "query": { "license_number": "ECOSTSC758NN" },  "result": {    "license_number": "ECOSTSC758NN",    "business_name": "!ECO STAR C G CONSTRUCTION LLC",    "status": "active",    "license_type": "CONSTRUCTION CONTRACTOR",    "bonded": {      "is_bonded": true,      "details": "Surety: NORTH RIVER INSURANCE COMPANY THE; Bond #: 46CF842686; Amount: $30,000; Effective: 2025-08-05; Expires: Until Canceled"    },    "insured": {      "has_insurance": true,      "details": "Carrier: State National Ins Co Inc; Policy: NXT9PTHTLT-01-GL; Coverage: $1,000,000; Agency: Next Insurance Inc; Effective: 2026-06-12; Expires: 2027-06-12"    },    "effective_date": "2025-08-15",    "expiration_date": "2027-08-15"  },  "source_url": "https://data.wa.gov/resource/m8qx-ubtq",  "retrieved_at": "2026-06-26T01:34:37.598Z",  "raw": { ... }}

status is always one of: active | expired | suspended | revoked | unknown.

On failure: { "found": false, "error": "SESSION_ERROR|NETWORK_ERROR|...", "message": "..." } — never a crash, never a charge.

Local test

bash
npm installnpm run buildecho '{"jurisdiction":"WA","license_number":"ECOSTSC758NN"}' \  > storage/key_value_stores/default/INPUT.jsonnpx apify run

MCP Server (stdio)

For use with Claude Desktop, Smithery, or any MCP-compatible agent.

Tools

verify_license — verify a contractor's license status.

  • jurisdiction (required): "WA" or "CA"
  • license_number and/or business_name (at least one required)

list_supported_jurisdictions — list all states with their status and data source.

Config (Claude Desktop)

json
{  "mcpServers": {    "license-verify": {      "command": "node",      "args": ["/absolute/path/to/license-verify-mcp/dist/index.js"]    }  }}

Run

bash
npm install && npm run buildnpm run start:mcp   # stdio MCP servernpm run smoke       # hit real WA + CA endpoints, must be 8/8 PASS

Adding a State

  1. Create src/providers/<CODE>.ts implementing the Provider interface ({ info, verify() })
  2. Register it in src/providers/index.ts

No other changes needed in server or Actor.

License

MIT

来源：README.md，提交 2a7ed90

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分