Server data from the Official MCP Registry
Verify contractor licenses: 50 states + DC + 8 cities — status, expiration, disciplinary history.
Verify contractor licenses: 50 states + DC + 8 cities — status, expiration, disciplinary history.
Remote endpoints: streamable-http: https://www.tradesapi.com/mcp
Valid MCP server (4 strong, 1 medium validity signals). 5 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: CLV_API_URL
Environment variable: CLV_API_KEY
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
From the project's GitHub README.
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.
No install required. Add this to your Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.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.
If you prefer to run the MCP server locally via stdio:
{
"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.
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.
npm install -g contractor-license-mcp-server
verify_licenseVerify a single contractor license against the official state (or city) licensing portal.
| Parameter | Required | Description |
|---|---|---|
state | yes | Two-letter state code (CA, TX, FL, ...) |
city | no | Optional city slug to target a municipal portal: chicago, nyc, philadelphia, detroit, atlanta, dallas, lasvegas, nashville. Lowercase, no spaces. |
license_number | yes | The license number to verify |
trade | no | general, electrical, plumbing, hvac, mechanical, roofing, residential, ... (defaults to general) |
force_refresh | no | Bypass the 24h cache and re-fetch from the portal |
response_format | no | markdown (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_verifyVerify up to 25 licenses in a single call. Each verification runs independently — partial failures do not block the batch. Per-item city is supported.
| Parameter | Required | Description |
|---|---|---|
licenses | yes | Array of { state, city?, license_number, trade } objects (1–25 items) |
response_format | no | markdown (default) or json |
search_by_nameFuzzy-match contractors by business or individual name within a single state (or city) database. Costs 2 credits per call.
| Parameter | Required | Description |
|---|---|---|
state | yes | Two-letter state code |
city | no | Optional city slug for municipal databases |
name | yes | Business or individual name (case-insensitive, partial-match tolerant) |
trade | no | Trade filter |
limit | no | Max results (1–50, default 20) |
response_format | no | markdown (default) or json |
Not every state portal supports name search — call list_supported_states and check supports_name_search per jurisdiction first.
list_supported_statesList 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.
| Parameter | Required | Description |
|---|---|---|
response_format | no | markdown (default) or json |
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.
| Variable | Required | Description |
|---|---|---|
CLV_API_URL | yes | API backend URL (use https://www.tradesapi.com) |
CLV_API_KEY | yes | Your API key from the dashboard |
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.
git clone https://github.com/jackunderwood/Contractor-License-Verification.git
cd Contractor-License-Verification/mcp-server
npm install
npm run build
npm test
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI