Contractor License Lookup MCP Server
An MCP server that lets you list licensed contractors by state and trade or look up individual contractor licenses across CA, TX, WA, OR, and LA.
Use the single
lookup_contractor_licensestool in list mode to find licensed contractors by state and trade, optionally filtering by cities, county, business name, active-only status, and max results.Use lookup mode to verify licenses or businesses via entries like
WA | 04CONCL862CRorLA | Acadian Builders, with optionalstates,license_number, andbusiness_nameinputs.Get license details including license number, status, active flag, issue/expiration dates, classifications, owners or qualifying parties, address, phone, and board source link.
Each search returns a free summary row; skipped, blocked, or empty searches return a
row_statusexplanation.Configure Washington principal retrieval with
include_owners, proxy reliability withproxy_mode, and an optional cost cap withmax_charge_usd.Requires an
APIFY_TOKEN; Apify bills per license row returned, and the tool is read-only.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Contractor License Lookup MCP Server Is Washington contractor license 04CONCL862CR active?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Contractor License Lookup MCP Server
An MCP server for the Mamba Labs Contractor License Search, CA, TX, WA, OR, LA 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
Related MCP server: license-verify-mcp
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 |
| string | list (default) or lookup |
| array | CA, TX, WA, OR, LA |
| array | List mode. Trade words |
| array | List mode. Cities, searched separately |
| string | List mode. County (CA, TX, OR) |
| string | List mode: name filter. Lookup mode: one more name |
| array | Lookup mode. Lines such as |
| string | Lookup mode. One more license number |
| string | true or false. Default true |
| string | Washington principals. Default true |
| string | Rows per search, up to 5000 |
| string | Optional cost cap for the run |
| 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 |
| $0.004 | $0.0038 | $0.0036 | $0.0034 |
| $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.
Available Tools
1 toollookup_contractor_licensesLook up contractor licensesARead-only
Look up contractor licenses, or list licensed contractors by trade, from the public registers of the California, Texas, Washington, Oregon, and Louisiana state licensing boards. mode list: give states and trades (plumbing, roofing, hvac, electrical, general, and more), optionally cities or a county, and get one row per licensed contractor. mode lookup: give lookups such as WA | 04CONCL862CR or LA | Acadian Builders and get the matching license. Each row carries license number, status, active flag, issue and expiration dates, classifications, owners or qualifying parties, address, phone, and the board source link; each search ends with one free summary row. California name and number lookups are skipped because the CSLB license check page uses a reCAPTCHA. Skipped, blocked, or empty searches come back free with a row_status saying so. A run that does not succeed is returned as an error with its run ID. Read-only; requires an APIFY_TOKEN; Apify charges per license row returned.
Inputs: mode, cities, county, states, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusing it with another tool. The two modes (list and lookup) are clearly described within the same tool, avoiding cross-tool ambiguity.
The single tool name 'lookup_contractor_licenses' follows a clear verb_noun pattern. With only one tool, consistency is trivially perfect.
The server offers exactly one tool, which the rubric explicitly flags as 'too few (1)' for the apparent scope. While the tool is feature-rich with two modes, a single tool for multi-state licensing lookups may feel thin.
The tool provides both listing by trade and direct lookup across five states, covering the core read-only use case. However, California name/number lookups are skipped due to reCAPTCHA, and only five states are supported, leaving minor gaps.
Maintenance
Related MCP Connectors
Search and verify 79k state-licensed US contractors, checked weekly against the licensing boards.
Search licensed US contractors by trade or location, fetch profiles and reviews, and submit leads.
Verify contractor licenses: 50 states + DC + 8 cities — status, expiration, disciplinary history.
Oregon CCB and Washington L&I contractor license status, expiry dates, and changes via Apify.
Related MCP Servers
- AlicenseAqualityDmaintenanceReal-time contractor license verification across 45 US states. Verifies license status, expiration, and disciplinary history directly against state licensing board portals.453 npmMIT
- AlicenseAqualityDmaintenanceVerifies contractor license status mid-task, returning normalized JSON with active/expired/suspended/revoked status, bond details, and insurance for WA (reliable) and CA (beta) jurisdictions.280 npmMIT
- FlicenseNot gradedqualityCmaintenanceVerifies Texas plumbing contractor licenses in real time from official TSBPE data, supporting lookups by contractor name, license number, and county. It charges $0.05 USDC per paid query using the x402 protocol, with free discovery tools.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents and procurement systems to verify contractor licenses against official state boards, search contractors by trade and location, audit workers' comp, surety bonds and OSHA safety records, and check SAM.gov federal debarment status. It returns a deterministic ALLOW/WARN/BLOCK compliance decision plus registry health metrics for US trade contractors.MIT