Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Contractor License Verification (TradesAPI)

by Noquarter6version 0.8.0i★ 0iComputer or cloudOfficial site ↗
Registry nameio.github.Noquarter6/contractor-license-mcp-server

How to install

What it does

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

  • Connects Computer or cloud
  • Account or key Cloud: Needs Authorization · Local: Needs CLV_API_KEY · 1 setting to fill in (CLV_API_URL)
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score15/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Contractor License Verification (TradesAPI). Follow https://mcp.popnx.com/i/noquarter6-contractor-license-mcp-server.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (www.tradesapi.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 5 min

You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Sign up and create a Contractor License Verification (TradesAPI) key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Contractor License Verification (TradesAPI) site ↗

  2. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameContractor License Verification (TradesAPI)
    Remote MCP server URL · Addresshttps://www.tradesapi.com/mcp

    Under Request headers, add this name and value

    Header nameAuthorization
    ValueBearer <paste your key here>

    Paste the key only into the app’s field, never into a chat or to anyone

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  4. Turn it on in a chat

    +ConnectorsContractor License Verification (TradesAPI)

  5. Try it

    Use Contractor License Verification (TradesAPI) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Contractor License Verification (TradesAPI) or shows a Contractor License Verification (TradesAPI) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Contractor License Verification (TradesAPI) yet

Contractor License Verification (TradesAPI) needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify

What you can do instead

A · Use an app that can connect Contractor License Verification (TradesAPI)

  • You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
  • You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)
  • You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)
  • You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code · about 5 min

You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)

  1. Sign up and create a Contractor License Verification (TradesAPI) key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Contractor License Verification (TradesAPI) site ↗

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --transport http --scope user contractor-license https://www.tradesapi.com/mcp --header 'Authorization: Bearer your-value'

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Type /mcp in Claude Code

    You should see Contractor License Verification (TradesAPI) listed as connected

  5. Try it

    Use Contractor License Verification (TradesAPI) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Contractor License Verification (TradesAPI) or shows a Contractor License Verification (TradesAPI) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 5 min

You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)

  1. Sign up and create a Contractor License Verification (TradesAPI) key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Contractor License Verification (TradesAPI) site ↗

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Fill in your key

    In the Contractor License Verification (TradesAPI) settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in Cursor in Agent mode

  5. Try it

    Use Contractor License Verification (TradesAPI) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Contractor License Verification (TradesAPI) or shows a Contractor License Verification (TradesAPI) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 5 min

You need a Contractor License Verification (TradesAPI) key (create it on the maker’s site)

  1. Sign up and create a Contractor License Verification (TradesAPI) key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Contractor License Verification (TradesAPI) site ↗

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Fill in your key

    In the Contractor License Verification (TradesAPI) settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in VS Code in Agent mode

  5. Try it

    Use Contractor License Verification (TradesAPI) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Contractor License Verification (TradesAPI) or shows a Contractor License Verification (TradesAPI) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://www.tradesapi.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Contractor License Verification (TradesAPI)💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user contractor-license https://www.tradesapi.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "contractor-license": {
      "url": "https://www.tradesapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "contractor-license": {
      "type": "http",
      "url": "https://www.tradesapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user contractor-license --env CLV_API_URL=https://www.tradesapi.com --env CLV_API_KEY=your-value -- npx -y contractor-license-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "contractor-license": {
      "command": "npx",
      "args": [
        "-y",
        "contractor-license-mcp-server"
      ],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "contractor-license": {
      "command": "npx",
      "args": [
        "-y",
        "contractor-license-mcp-server"
      ],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "contractor-license": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "contractor-license-mcp-server"
      ],
      "env": {
        "CLV_API_URL": "https://www.tradesapi.com",
        "CLV_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • CLV_API_URL required env
    TradesAPI backend URL. Use https://www.tradesapi.com unless you have a reason to override.
  • CLV_API_KEY secret required env
    Your TradesAPI key. Get one free at https://www.tradesapi.com (50 credits, no credit card).
  • Authorization secret required HTTP header
    Your TradesAPI key as a Bearer token. Get one free at https://www.tradesapi.com (50 credits, no credit card).

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
56/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.8.0
Categoryi
Other
Published to registryi
May 7, 2026
Code last changedi
Oct 16, 2026
Last checked
Nov 15, 2026
Maker
Noquarter6
Packages
npm: contractor-license-mcp-server
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

The server asks you to sign in before it lists its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account Noquarter6, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 34 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 430 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for contractor-license-mcp-server@0.8.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/noquarter6-contractor-license-mcp-server.svg)](https://mcp.popnx.com/en/servers/noquarter6-contractor-license-mcp-server)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 0% of the other 20653 servers in this category
  • Published to the registry more recently than 6% of the other 20653 servers in this category
  • Basic checks equal to or better than 99% of the other 20653 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Contractor License Verification (TradesAPI) safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization, CLV_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 34 days ago, and the latest version (0.8.0) reached the registry 7 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
Contractor License Verification (TradesAPI)
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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
{

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

{

"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

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
FieldValue
NameANDERSON, ORIN RAE
License #TACLA00000103C
StateTX
Tradehvac
StatusActive
Expiration05/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

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