Contractor License Verification (TradesAPI)

io.github.Noquarter6v0.8.0更新於 Oct 10, 2026

Verify contractor licenses: 50 states + DC + 8 cities — status, expiration, disciplinary history.

已驗證Streamable HTTP可網頁執行Business & Commerce

概覽

AI 產生的概覽

讓助理查詢與驗證美國承包商執照，涵蓋各州、華盛頓特區及部分城市，包括狀態、有效期限與懲戒紀錄。

功能
此伺服器將助理連接到 TradesAPI 承包商執照驗證服務。根據登錄描述，它涵蓋 50 州、華盛頓特區與 8 個城市，可回傳執照狀態、有效期限與懲戒歷史。它既能以遠端端點方式存取，也能以 npm 套件透過 stdio 在本機執行。
適用情境
適合在雇用、簽約或審查承包商或技師之前確認其是否持有執照，也適合讓助理查詢特定個人或企業的執照狀態與懲戒紀錄。
執行需求
需要 TradesAPI 金鑰，透過 CLV_API_KEY 環境變數或 Authorization Bearer 標頭提供。另需 CLV_API_URL 環境變數，預設指向 TradesAPI 後端。遠端端點需要網路存取；本機方式需要 Node.js，透過 npx 執行該 npm 套件。
安裝前請注意
此伺服器需要密鑰（CLV_API_KEY 或 Authorization 標頭），請避免寫入共享日誌或設定檔。驗證結果屬第三方資料，在用於雇用或法律決策前應向官方執照管理機關確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Contractor License Verification (TradesAPI)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "contractor-license-mcp-server": {
      "type": "http",
      "url": "https://www.tradesapi.com/mcp"
    }
  }
}

README

contractor-license-mcp-server

Real-time contractor license verification across all 50 US states + DC, plus 8 major-city contractor licensing portals (Chicago, NYC, Philadelphia, Detroit, Atlanta, Dallas, Las Vegas, Nashville). An MCP server that lets Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible AI agent verify a contractor's license, status, expiration, and disciplinary history directly against licensing board portals.

Send {state, license_number, trade} — get back validity, licensee name, expiration date, status, and any disciplinary actions on file. Results are fetched live from official state portals (no stale nightly exports) and cached for 24 hours when active.

Why this server

  • All 50 US states + DC + 8 major cities covered via official licensing board portals, not third-party data aggregators
  • Live lookups — each verification hits the authoritative portal, so expirations and disciplinary actions are as fresh as the board's own data
  • Batch verification — up to 25 licenses per call, run in parallel
  • Disciplinary history — returned when the portal exposes it
  • Backed by TradesAPI, a hosted HTTP API you can also hit directly

Quick start

Hosted (recommended)

No install required. Add this to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "tradesapi": {      "type": "streamable-http",      "url": "https://www.tradesapi.com/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

Replace YOUR_API_KEY with the key from your dashboard and restart Claude Desktop.

Local install (alternative)

If you prefer to run the MCP server locally via stdio:

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

Restart Claude Desktop after saving.

Getting an API key

  1. Go to www.tradesapi.com and click Sign up free
  2. Enter your email — you'll get a magic link
  3. Click the link and land on your dashboard, where your API key is waiting

New accounts start with 50 free verification credits, no credit card required. You can purchase additional credit packs from the dashboard when you need more.

Direct install

bash
npm install -g contractor-license-mcp-server

Tools

verify_license

Verify a single contractor license against the official state (or city) licensing portal.

ParameterRequiredDescription
stateyesTwo-letter state code (CA, TX, FL, ...)
citynoOptional city slug to target a municipal portal: chicago, nyc, philadelphia, detroit, atlanta, dallas, lasvegas, nashville. Lowercase, no spaces.
license_numberyesThe license number to verify
tradenogeneral, electrical, plumbing, hvac, mechanical, roofing, residential, ... (defaults to general)
force_refreshnoBypass the 24h cache and re-fetch from the portal
response_formatnomarkdown (default) or json

Example result:

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

batch_verify

Verify up to 25 licenses in a single call. Each verification runs independently — partial failures do not block the batch. Per-item city is supported.

ParameterRequiredDescription
licensesyesArray of { state, city?, license_number, trade } objects (1–25 items)
response_formatnomarkdown (default) or json

search_by_name

Fuzzy-match contractors by business or individual name within a single state (or city) database. Costs 2 credits per call.

ParameterRequiredDescription
stateyesTwo-letter state code
citynoOptional city slug for municipal databases
nameyesBusiness or individual name (case-insensitive, partial-match tolerant)
tradenoTrade filter
limitnoMax results (1–50, default 20)
response_formatnomarkdown (default) or json

Not every state portal supports name search — call list_supported_states and check supports_name_search per jurisdiction first.

list_supported_states

List every supported jurisdiction with portal URLs, current health, available trades, and registered municipal scrapers nested under each state. Use this to discover what's reachable before constructing other tool calls.

ParameterRequiredDescription
response_formatnomarkdown (default) or json

Coverage

All 50 US states + DC at the state level, plus 8 major-city contractor licensing portals (Chicago, NYC, Philadelphia, Detroit, Atlanta, Dallas, Las Vegas, Nashville).

Run list_supported_states from your agent for the live, fetched-fresh-each-call list of supported jurisdictions, available trades per jurisdiction, current portal health, and which states support name search. The MCP package no longer bundles a static state table — what comes back from list_supported_states is always current with prod.

You can also see the live state grid at www.tradesapi.com.

Configuration

VariableRequiredDescription
CLV_API_URLyesAPI backend URL (use https://www.tradesapi.com)
CLV_API_KEYyesYour API key from the dashboard

Credits

Each license verification consumes 1 credit, whether the result is fresh or cached. New accounts receive 50 free credits. Additional credit packs can be purchased from the dashboard at www.tradesapi.com.

Development

bash
git clone https://github.com/jackunderwood/Contractor-License-Verification.gitcd Contractor-License-Verification/mcp-servernpm installnpm run buildnpm test

License

MIT

來源：README.md，提交 c293207

工具

0
工具後設資料尚未被收錄。

版本歷史

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