contractor-license-mcp-server

An MCP server for verifying US contractor licenses. Send a license number, state, and trade -- get back validity, expiration, status, and disciplinary history. Works with Claude Desktop and any MCP-compatible AI agent.

Currently supports Texas (TDLR), California (CSLB), and Florida (DBPR), with more states coming.

Quick Start

Claude Desktop

Add this to your Claude Desktop config file:

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

{
  "mcpServers": {
    "contractor-license-verification": {
      "command": "npx",
      "args": ["-y", "contractor-license-mcp-server"],
      "env": {
        "CLV_API_URL": "https://contractor-license-verification-production.up.railway.app",
        "CLV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop after saving the config.

Getting an API Key

New accounts start with 50 free verification credits. To get your API key:

1. Visit the billing portal to create an account
2. Your API key will be provided on signup
3. Need more credits? Purchase additional packs at the same billing portal

Direct Install

npm install -g contractor-license-mcp-server

Available Tools

clv_verify_license

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

Parameters:

| Name | Required | Description | |------|----------|-------------| | state | Yes | Two-letter state code (e.g. CA, TX, FL) | | license_number | Yes | The license number to verify | | trade | No | Trade type (default: general) | | force_refresh | No | Bypass cache for fresh data (default: false) | | response_format | No | markdown or json (default: markdown) |

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 license is verified independently -- partial failures do not block the batch.

Parameters:

| Name | Required | Description | |------|----------|-------------| | licenses | Yes | Array of { state, license_number, trade } objects (1-25 items) | | response_format | No | markdown or json (default: markdown) |

clv_list_supported_states

List all states currently supported for verification, including portal URLs and available trades.

Parameters:

| Name | Required | Description | |------|----------|-------------| | response_format | No | markdown or json (default: markdown) |

Supported States

| Code | State | Portal | Trades | |------|------------|--------|---------------------| | TX | Texas | TDLR | hvac, electrical | | CA | California | CSLB | general | | FL | Florida | DBPR | general |

More states are being added. Run clv_list_supported_states for the latest list.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | CLV_API_URL | Yes | API backend URL | | CLV_API_KEY | Yes | Your API key |

Credits

Each license verification consumes 1 credit (including cached results). New accounts receive 50 free credits. Purchase additional credit packs via POST /billing/checkout with your API key.

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