Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Contractor License Lookup

FreeMaintained

Contractor license lookup and trade lists from CA, TX, WA, OR, and LA state licensing boards.

GitHubEmbed

About

Contractor license lookup and trade lists from CA, TX, WA, OR, and LA state licensing boards.

README

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

An MCP server for the Mamba Labs Contractor License Lookup actor on Apify. Give it a state and a trade to list licensed contractors, or a license number or business name to verify one. Each run reads the state licensing board's own public register.

What's Inside

What it does

Two modes:

  • list: give states and trades (for example CA and roofing), optionally cities or a county. You get one row per licensed contractor with license number, status, expiration date, classifications, owners or qualifying parties, address, and phone.
  • lookup: give lookups, one per line, for example WA | 04CONCL862CR or LA | Acadian Builders. You get the matching license with its status.

States covered: California (CSLB Data Portal lists), Texas (TDLR open data), Washington (Labor and Industries open data), Oregon (CCB open data), and Louisiana (LSLBC public search). California name and number lookups work only inside a trade list, because the CSLB license check page uses a reCAPTCHA. Each search ends with one free summary row. All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-contractor-license-lookup": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-contractor-license-lookup"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The lookup_contractor_licenses tool appears.

Prerequisites

Example prompts

  • "List the licensed roofing contractors in San Diego County, California."
  • "Is Washington contractor license 04CONCL862CR active, and who are the principals?"
  • "Find licensed HVAC contractors in Austin, Texas, with their phone numbers."

Tool

lookup_contractor_licenses. One tool. Example arguments:

{
  "mode": "list",
  "states": ["CA"],
  "trades": ["roofing"],
  "county": "San Diego",
  "max_results": "100"
}

Inputs

Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and booleans are sent as strings.

Input Type Description
mode string list (default) or lookup
states array CA, TX, WA, OR, LA
trades array List mode. Trade words
cities array List mode. Cities, searched separately
county string List mode. County (CA, TX, OR)
business_name string List mode: name filter. Lookup mode: one more name
lookups array Lookup mode. Lines such as WA | 04CONCL862CR
license_number string Lookup mode. One more license number
active_only string true or false. Default true
include_owners string Washington principals. Default true
max_results string Rows per search, up to 5000
max_charge_usd string Optional cost cap for the run
proxy_mode string auto or residential. Default auto

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event Free plan Bronze Silver Gold
license-row, per license returned $0.004 $0.0038 $0.0036 $0.0034
apify-actor-start, per run start $0.0005 $0.0005 $0.0005 $0.0005

Search summary rows, and skipped, blocked, and no result rows, are free.

Your keys

The actor needs no key. It reads the state boards' public registers and holds no key of any kind. Proxy traffic adds nothing to your price: Mamba Labs pays the platform costs of the run. proxy_mode is a reliability setting.

Full actor documentation

apify.com/mambalabs/contractor-license-lookup

License

MIT. See LICENSE.

from github.com/mambalabsdev/mcp-contractor-license-lookup

Install Contractor License Lookup in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install mcp-contractor-license-lookup

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add mcp-contractor-license-lookup --env APIFY_TOKEN="" -- npx -y @mambalabsdev/mcp-contractor-license-lookup

Step-by-step: how to install Contractor License Lookup

FAQ

Is Contractor License Lookup MCP free?

Yes, Contractor License Lookup MCP is free — one-click install via Unyly at no cost.

Does Contractor License Lookup need an API key?

Yes, it requires environment variables: APIFY_TOKEN. Unyly injects them into the config during install.

Is Contractor License Lookup hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Contractor License Lookup in Claude Desktop, Claude Code or Cursor?

Open Contractor License Lookup on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Contractor License Lookup with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs