Contractor License Lookup
FreeMaintainedContractor license lookup and trade lists from CA, TX, WA, OR, and LA state licensing boards.
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
- Quick start
- Prerequisites
- Example prompts
- Tool
- Inputs
- Pricing
- Your keys
- Full actor documentation
- License
What it does
Two modes:
- list: give
statesandtrades(for example CA and roofing), optionallycitiesor acounty. 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 exampleWA | 04CONCL862CRorLA | 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
- Node.js 18 or newer.
- An Apify API token from console.apify.com/account/integrations, set as
APIFY_TOKEN. The server lists its tool without a token; a call needs one.
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.
Install Contractor License Lookup in Claude Desktop, Claude Code & Cursor
unyly install mcp-contractor-license-lookupInstalls 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-lookupStep-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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Unyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoTemplate MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectSupabase
Database, auth and storage
by SupabaseEverything
Reference / test server with prompts, resources, and tools.
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
