Contractor License MCP Server

Real-time contractor license verification across all 50 US states + DC plus 8 major-city portals (Chicago, NYC, Philadelphia, Detroit, Atlanta

Remote serverstreamable-httpGo

What is the Contractor License MCP server?

Contractor License MCP server exists for a simple reason — assistants are far more useful when they can act on Contractor License directly instead of describing what you should do. Real-time contractor license verification across all 50 US states + DC plus 8 major-city portals (Chicago, NYC, Philadelphia, Detroit, Atlanta, Dallas, Las Vegas, Nashville). MCP server for Claude Desktop, Claude Code, Cursor, Windsurf.

What you get

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.

  • 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

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

What the assistant can call

Once Contractor License is connected, these are the calls the assistant has available:

  • verify_license — Verify a single contractor license against the official state (or city) licensing portal
  • 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
  • search_by_name — Fuzzy-match contractors by business or individual name within a single state (or city) database. Costs 2 credits per call
  • list_supported_states — List every supported jurisdiction with portal URLs, current health, available trades, and registered municipal scrapers nested under each state. Use

Configuration and credentials

You will need 3 environment variables: CLV_API_URL, CLV_API_KEY, YOUR_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the contractor license mcp server does with a few real requests.

Choosing this one

Among the database access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Contractor License's toolset — verify_license, batch_verify, search_by_name and 1 more — is a fair guide to whether it matches your workflow. It is maintained by noquarter6; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
verify_licenseVerify a single contractor license against the official state (or city) licensing portal.
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.
search_by_nameFuzzy-match contractors by business or individual name within a single state (or city) database. Costs 2 credits per call.
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.

How to install the Contractor License MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
CLV_API_URLEndpoint or connection string the server talks to.Yes
CLV_API_KEYCredential the server authenticates with.Yes
YOUR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Contractor License to verify license.
  • Use Contractor License to batch verify.
  • Use Contractor License to search by name.

Frequently asked questions

It connects Contractor License to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (verify_license, batch_verify, search_by_name, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Contractor License directly.