Tradesapi

contractor-license-mcp-server

米国50州すべてとDCに加え、主要8都市（シカゴ、ニューヨーク市、フィラデルフィア、デトロイト、アトランタ、ダラス、ラスベガス、ナッシュビル）の請負業者ライセンスをリアルタイムで確認できます。 Claude Desktop、Claude Code、Cursor、Windsurf、およびMCP互換のAIエージェントから、ライセンス委員会のポータルに直接照会し、請負業者のライセンス、ステータス、有効期限、懲戒履歴を確認できるMCP サーバーです。

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

このサーバーを選ぶ理由

• 米国50州すべてとDC、主要8都市を網羅。サードパーティのデータ集約サービスではなく、公式のライセンス委員会ポータルを通じて確認します
• リアルタイムの照会 — 検証のたびに正式なポータルに照会するため、有効期限や懲戒処分は委員会が保有するデータと同じ鮮度です
• 一括検証 — 1回の呼び出しで最大25件のライセンスを並列処理します
• 懲戒履歴 — ポータルで公開されている場合は返されます
• TradesAPI が提供するホスト型HTTP APIを基盤としており、APIに直接アクセスすることもできます

クイックスタート

ホスト型（推奨）

インストールは不要です。以下をClaude Desktopの設定に追加してください。

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

{
  "mcpServers": {
    "tradesapi": {
      "type": "streamable-http",
      "url": "https://www.tradesapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

YOUR_API_KEYをダッシュボードで取得したキーに置き換え、Claude Desktopを再起動してください。

ローカルインストール（代替方法）

stdio経由でMCP サーバーをローカル実行する場合は、以下を使用してください。

{
  "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キーの取得

1. www.tradesapi.comにアクセスし、Sign up freeをクリックします
2. メールアドレスを入力すると、マジックリンクが届きます
3. リンクをクリックするとダッシュボードが開き、APIキーを確認できます

新しいアカウントには、クレジットカード不要で50回分の無料検証クレジットが付与されます。追加で必要になった場合は、ダッシュボードからクレジットパックを購入できます。

直接インストール

npm install -g contractor-license-mcp-server

ツール

verify_license

公式の州（または市）のライセンス発行ポータルで、請負業者のライセンスを1件検証します。

パラメーター	必須	説明
state	はい	2文字の州コード（CA、TX、FLなど）
city	いいえ	市のポータルを指定する任意の市のスラッグ：chicago、nyc、philadelphia、detroit、atlanta、dallas、lasvegas、nashville。小文字で、スペースは含めません。
license_number	はい	検証するライセンス番号
trade	いいえ	general、electrical、plumbing、hvac、mechanical、roofing、residentialなど（デフォルトは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               |

batch_verify

1回の呼び出しで最大25件のライセンスを検証します。各検証は個別に実行されるため、一部の失敗によってバッチ全体が中断されることはありません。項目ごとのcity指定に対応しています。

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

search_by_name

単一の州（または市）のデータベース内で、事業者名または個人名から請負業者をあいまい検索します。1回の呼び出しにつき2クレジットを消費します。

パラメーター	必須	説明
state	はい	2文字の州コード
city	いいえ	市のデータベースを指定する任意の市のスラッグ
name	はい	事業者名または個人名（大文字と小文字を区別せず、部分一致にも対応）
trade	いいえ	業種フィルター
limit	いいえ	最大結果数（1～50、デフォルトは20）
response_format	いいえ	markdown（デフォルト）またはjson

州のポータルすべてが名前検索に対応しているわけではありません。まずlist_supported_statesを呼び出し、各管轄区域のsupports_name_searchを確認してください。

list_supported_states

ポータルの URL、現在の稼働状況、利用可能な業種、各州の下にネストされた登録済みの自治体スクレイパーとともに、対応しているすべての管轄区域を一覧表示します。他のツール呼び出しを組み立てる前に、アクセス可能な対象を確認するために使用します。

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

対応範囲

州レベルでは米国の全50州と DC に対応し、さらに大都市8市の請負業者ライセンス用ポータル（シカゴ、NYC、フィラデルフィア、デトロイト、アトランタ、ダラス、ラスベガス、ナッシュビル）にも対応しています。

エージェントから list_supported_states を実行すると、対応している管轄区域、管轄区域ごとに利用可能な業種、現在のポータル稼働状況、名前検索に対応している州の一覧を、その都度最新の情報として取得できます。MCP パッケージには静的な州テーブルは同梱されなくなりました。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