contractor-license-mcp-server

全米45州の建設業者ライセンスをリアルタイムで検証します。 MCPサーバーであり、Claude Desktop、Cursor、およびMCP互換のAIエージェントが、建設業者のライセンス、ステータス、有効期限、懲戒履歴を州のライセンス委員会ポータルから直接検証できるようにします。

{state, license_number, trade} を送信すると、有効性、ライセンス保持者名、有効期限、ステータス、および記録されている懲戒処分が返されます。結果は公式の州ポータルからライブで取得され（古い夜間エクスポートデータではありません）、アクティブな場合は24時間キャッシュされます。

このサーバーの利点

45州をカバー：サードパーティのデータアグリゲーターではなく、公式の州ライセンス委員会ポータル経由で取得
ライブ検索 — 各検証は権威あるポータルにアクセスするため、有効期限や懲戒処分は委員会自身のデータと同じくらい最新です
バッチ検証 — 1回の呼び出しで最大25件のライセンスを並列実行
懲戒履歴 — ポータルで公開されている場合に返されます
TradesAPIを利用 — 直接アクセス可能なホスト型HTTP API

クイックスタート

Claude Desktop

Claude Desktopの設定に以下を追加してください：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tradesapi": {
      "command": "npx",
      "args": ["-y", "contractor-license-mcp-server"],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-api-key-here"
      }
    }
  }
}

保存後、Claude Desktopを再起動してください。

APIキーの取得

www.tradesapi.com にアクセスし、Sign up freeをクリックします
メールアドレスを入力すると、マジックリンクが届きます
リンクをクリックしてダッシュボードに移動すると、APIキーが表示されます

新規アカウントには50件の無料検証クレジットが付与されます（クレジットカード不要）。必要に応じて、ダッシュボードから追加のクレジットパックを購入できます。

直接インストール

npm install -g contractor-license-mcp-server

ツール

`clv_verify_license`

単一の建設業者ライセンスを州のライセンス委員会ポータルで検証します。

パラメータ	必須	説明
`state`	はい	2文字の州コード (`CA`, `TX`, `FL` など)
`license_number`	はい	検証するライセンス番号
`trade`	いいえ	`general`, `electrical`, `plumbing`, `hvac`, `mechanical`, `residential`, `home_inspection` のいずれか（デフォルトは `general`）
`force_refresh`	いいえ	24時間のキャッシュをバイパスしてポータルから再取得する
`response_format`	いいえ	`markdown` (デフォルト) または `json`

結果の例:

## License Verification: VALID

| Field      | Value                    |
|------------|--------------------------|
| Name       | ANDERSON, ORIN RAE       |
| License #  | TACLA00000103C           |
| State      | TX                       |
| Trade      | hvac                     |
| Status     | Active                   |
| Expiration | 05/12/2026               |

`clv_batch_verify`

1回の呼び出しで最大25件のライセンスを検証します。各検証は独立して実行されるため、一部の失敗がバッチ全体をブロックすることはありません。

パラメータ	必須	説明
`licenses`	はい	`{ state, license_number, trade }` オブジェクトの配列 (1〜25件)
`response_format`	いいえ	`markdown` (デフォルト) または `json`

`clv_list_supported_states`

ポータルのURLや利用可能な業種を含む、サポートされているすべての州を一覧表示します。どの州や業種を照会できるかを確認するために使用します。

パラメータ	必須	説明
`response_format`	いいえ	`markdown` (デフォルト) または `json`

サポートされている州

コード	州	業種
AK	アラスカ	general, electrical, mechanical
AL	アラバマ	general, electrical, plumbing, hvac, residential
AR	アーカンソー	general
AZ	アリゾナ	general, electrical, plumbing, hvac
CA	カリフォルニア	general, electrical, plumbing, hvac
CO	コロラド	electrical, plumbing
CT	コネチカット	general, electrical, plumbing, hvac
DC	コロンビア特別区	general
DE	デラウェア	electrical, plumbing, hvac
FL	フロリダ	general, electrical, plumbing, hvac
GA	ジョージア	general
HI	ハワイ	general
IA	アイオワ	electrical
ID	アイダホ	electrical, plumbing, hvac
IL	イリノイ	general, electrical, plumbing, hvac
IN	インディアナ	plumbing
KY	ケンタッキー	general, electrical, hvac, plumbing
LA	ルイジアナ	general
MA	マサチューセッツ	general, mechanical
MD	メリーランド	general, hvac, electrical, plumbing
ME	メイン	electrical, plumbing
MI	ミシガン	electrical, plumbing, hvac
MN	ミネソタ	general, electrical, plumbing
MS	ミシシッピ	general
NC	ノースカロライナ	general
ND	ノースダコタ	general, electrical
NE	ネブラスカ	general, electrical
NH	ニューハンプシャー	electrical, plumbing
NJ	ニュージャージー	general, electrical, hvac, plumbing
NM	ニューメキシコ	general, electrical, plumbing, hvac
NV	ネバダ	general, electrical, plumbing, hvac
NY	ニューヨーク	home_inspection
OH	オハイオ	general, electrical, plumbing, hvac
OK	オクラホマ	electrical, plumbing, hvac
OR	オレゴン	general
PA	ペンシルベニア	general, electrical, hvac, plumbing
RI	ロードアイランド	general
SC	サウスカロライナ	general, electrical, plumbing, hvac
TN	テネシー	general, electrical, plumbing
TX	テキサス	hvac, electrical, plumbing
UT	ユタ	general, electrical, plumbing, hvac
VA	バージニア	general, electrical, plumbing, hvac
VT	バーモント	electrical, plumbing
WA	ワシントン	general
WV	ウェストバージニア	general, electrical, hvac, plumbing

カバレッジは継続的に拡大しています。最新のリストについてはエージェントから clv_list_supported_states を実行するか、www.tradesapi.com のライブステートグリッドを参照してください。

設定

変数	必須	説明
`CLV_API_URL`	はい	APIバックエンドURL (`https://www.tradesapi.com` を使用)
`CLV_API_KEY`	はい	ダッシュボードから取得したAPIキー

クレジット

結果が新規かキャッシュかにかかわらず、ライセンス検証1件につき1クレジットを消費します。新規アカウントには50件の無料クレジットが付与されます。追加のクレジットパックは www.tradesapi.com のダッシュボードから購入できます。

開発

git clone https://github.com/jackunderwood/Contractor-License-Verification.git
cd Contractor-License-Verification/mcp-server
npm install
npm run build
npm test

ライセンス

MIT

contractor-license-mcp-server

contractor-license-mcp-server

このサーバーの利点

クイックスタート

Claude Desktop

APIキーの取得

直接インストール

ツール

`clv_verify_license`

`clv_batch_verify`

`clv_list_supported_states`

サポートされている州

設定

クレジット

開発

ライセンス

Resources

Tools

Latest Blog Posts

MCP directory API