license-verify-mcp

施工業者のライセンス＋保証金＋保険確認（MCP、エージェントによる支払いに対応）

州のデータから、ライセンスの有効／無効だけでなく、公式の保証金＋保険情報を返す、MCP ネイティブの唯一のライセンス確認ツールです。成功ごとの従量課金：全結果は $0.03、ステータスのみは $0.01、見つからない場合は無料です。WA は稼働中（公式 L&I）、CA はベータ版（CSLB）です。

ツール：verify_license、list_supported_jurisdictions。

クイックスタート

// Call
{ "tool": "verify_license", "jurisdiction": "WA", "license_number": "ECOSTSC758NN" }

// 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" }
  }
}

結果	料金
全結果（ステータス＋保証金＋保険）	$0.03
ステータスのみ（保証金／保険の一致なし、または statusOnly: true）	$0.01
見つからない場合（found: false）	無料

---

対応地域

州	状態	ソース	保証金＋保険
WA	✅ 稼働中	WA L&I オープンデータ（data.wa.gov）	✅ 実データ（bzff-4fmt + ciwg-agsx datasets）
CA	⚠️ ベータ版	CSLB HTML（cslb.ca.gov）	✅ CSLB が稼働している場合に解析

Washington は信頼性の高い、本番環境ですぐに利用できる対応地域です。 公式の WA L&I オープンデータは Socrata JSON 経由で提供されます。スクレイピングやレート制限はなく、専用データセットから保証金と保険の情報も取得できます。

California はベータ版です。 CSLB はオープン API を公開していないため、プロバイダーは詳細ページの HTML を直接取得します。CSLB は自動リクエストを断続的にレート制限するか、503 を返します。利用できない場合、verify_license は明確な SESSION_ERROR を返します。ソースの障害時に料金が請求されることはありません。 安定したサーバー側の CSLB 実行を確認できるまでは、本番のワークフローで CA に依存しないでください。

---

Apify Actor

エージェント決済に対応 — イベントごとの従量課金＋限定された権限＋Standby モードなし。

料金

イベント	料金
license-verification	$0.03 — 全結果（ステータス＋保証金＋保険）
status-only-result	$0.01 — ステータスは見つかったが、保証金／保険の一致なし（または statusOnly: true）

found: true の場合のみ課金されます。入力エラー、見つからない場合の結果、ソースの障害は課金対象外です。

入力

{
  "jurisdiction": "WA",
  "license_number": "ECOSTSC758NN"
}

フィールド	型	必須	備考
jurisdiction	"WA" | "CA"	✅	WA = 稼働中、CA = ベータ版
license_number	string	↓ のいずれか	WA：英数字。CA：数字、8 桁以下
business_name	string	↑ のいずれか	WA のみ。部分一致。matches[] が返される場合があります

出力（デフォルトのデータセット）

{
  "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 は常に次のいずれかです：active | expired | suspended | revoked | unknown。

失敗時：{ "found": false, "error": "SESSION_ERROR|NETWORK_ERROR|...", "message": "..." } — クラッシュせず、課金もされません。

ローカルテスト

npm install
npm run build
echo '{"jurisdiction":"WA","license_number":"ECOSTSC758NN"}' \
  > storage/key_value_stores/default/INPUT.json
npx apify run

---

MCP サーバー（stdio）

Claude Desktop、Smithery、または MCP 互換のエージェントで使用できます。

ツール

verify_license — 施工業者のライセンス状況を確認します。

• jurisdiction（必須）："WA" または "CA"
• license_number と business_name のいずれか、または両方（少なくとも一方は必須）

list_supported_jurisdictions — 対応するすべての州と、その状態およびデータソースを一覧表示します。

設定（Claude Desktop）

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

実行

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

---

州の追加

1. Provider インターフェース（{ info, verify() }）を実装する src/providers/<CODE>.ts を作成します
2. src/providers/index.ts に登録します

サーバーや Actor への変更はほかに必要ありません。

ライセンス

MIT