contractor-license-mcp-server

Real-time contractor license verification across 45 US states. An MCP server that lets Claude Desktop, Cursor, and any MCP-compatible AI agent verify a contractor's license, status, expiration, and disciplinary history directly against state 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

• 45 states covered via official state 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

Claude Desktop

Add this to your Claude Desktop config:

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

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

npm install -g contractor-license-mcp-server

Tools

clv_verify_license

Verify a single contractor license against a state licensing board portal.

Example result:

## License Verification: VALID

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

clv_batch_verify

Verify up to 25 licenses in a single call. Each verification runs independently — partial failures do not block the batch.

clv_list_supported_states

List all supported states, including portal URLs and available trades. Use this to see which states and trades you can query.

Supported states

Coverage expands continuously. Run clv_list_supported_states from your agent for the current list, or see the live state grid at www.tradesapi.com.

Configuration

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

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

License

MIT