How to check a contractor license with ChatGPT, Claude, or any AI assistant
To check a contractor license you need the right state board, the contractor's exact license number or business name, and a careful read of the record: status, expiry, the trades it covers, the bond, the insurance and any complaints. Each state runs its own lookup, and some publish more than others. With Firecrawl Alexandria connected, an AI assistant can query those boards for you, starting with the California Contractors State License Board, and return the record with a link back to the board's own page.
Starter prompt
Copy this into an assistant connected to Firecrawl, then fill in the contractor and the state:
Use Firecrawl Alexandria to check the contractor license of
[business name or license number] with the provider for the
state or city where the job is (California CSLB, Washington,
Oregon, Florida, Arizona, Colorado trade licenses or the City of
Pittsburgh). Tell me what each tool costs before you call it.
Report:
- License number, business name and whether the license is active
- Issue and expiration dates
- The classifications or trades the license covers
- Bond and workers' compensation or liability insurance on file
- Any complaint disclosures or discipline the board lists
- The link to the board's page for this license
Quote the board's status wording as returned. If several
licenses match the name, list them all and don't pick one.What counts as a contractor license check?
A useful check confirms four things from the state's record:
- Status and dates. Whether the license is active, suspended, expired or revoked, and when it runs out.
- Classification. The trades the license allows. A roofing license doesn't cover electrical work.
- Bond and insurance. The contractor's surety bond and the workers' compensation or liability coverage the board has on file.
- Complaints and discipline. Any cases, citations or disciplinary actions the board makes public.
Where to do a contractor license lookup
| Source | What you get | The catch |
|---|---|---|
| California CSLB Check a License | Search by license number, business name or personnel name, with complaint disclosure | The database goes offline Sunday 8 p.m. to Monday 6 a.m. for maintenance, and name search has fussy spelling rules |
| Washington L&I Verify | Contractor registration, workers' comp account, safety violations and lawsuits against the surety bond | Washington only, and you read each record page by hand |
| Oregon CCB, Florida DBPR and Arizona ROC | Each state board's own search for its licensed contractors | One state per site, each with different search fields and record layouts |
| Colorado DORA license lookup | State licenses for electricians, plumbers and other regulated professions | Colorado general contractors are licensed by cities and counties, so this lookup won't show them |
| An AI assistant with Firecrawl Alexandria | Records from the California, Washington, Oregon, Florida and Arizona boards, Colorado trade licenses and Pittsburgh city licenses, combined | Each lookup costs Firecrawl credits, and coverage stops at those states and one city |
How to check a contractor license with AI, step by step
- Plug your assistant into Firecrawl. Setup differs by assistant (Claude, ChatGPT, Claude Code, Cursor or another MCP client), and each gets a short section further down.
- Give the license number if you have it. It's printed on the contractor's bid, contract or pocket card. A business name works too, though it can match several licenses.
- Name the state. The assistant picks that board's tool in Firecrawl Alexandria, tells you the price and runs the search, then reads the full record for the license you confirm.
- Open the board's page. Records come back with a link to their source, usually the board's own listing. Confirm the status there before you sign, because the board's page is the official record.
What data can you get?
Seven licensing sources in Firecrawl Alexandria return contractor records:
| Tool | What it returns | Credits per call |
|---|---|---|
| California CSLB license record | Business name, address, phone, entity type, issue and expiry dates, the board's status sentence, classifications, every bond block, workers' compensation and miscellaneous actions | 5 |
| California CSLB name search | Up to 49 names starting with your text, each with license number, city, status and name type (business name, DBA or previous name) | 5 |
| California CSLB complaint disclosure | Public cases the board discloses for a license: case number, date, status and number of complaints | 5 |
| Washington L&I contractor search | Construction, electrical, plumbing and elevator registrations by name, number, UBI, city, ZIP, type, specialty and status; the full record adds principals, liability insurance and permit signers | 5 |
| Oregon CCB license search | Active CCB licenses with endorsements, surety bonds, liability insurance and the responsible managing individual, plus Building Codes Division electrical and plumbing licenses | 5 |
| Florida DBPR license search | Licensees by name or number, with board and county filters; follow-up tools return the detail page, related licenses such as qualifying agents, and the public complaint list | 5 |
| Arizona ROC contractor search | Contractors by name, ROC number, classification or city; the license record adds personnel, surety bonds and the public complaint history | 5 |
| Colorado DORA trade licenses | State electrical, plumbing and radon licenses (contractors, masters, journeymen, apprentices) with status, expiry and published discipline. No general contractors, bonds or insurance | 5 |
| Pittsburgh contractor licenses | City of Pittsburgh general, sign, electrical, HVAC and other licenses with status and term dates. No bonds, insurance or discipline | 5 |
On Nov 11, 2026, our test searches returned:
- California CSLB: a name search for "Swinerton" returned 38 rows, most of them expired or canceled joint-venture names, which shows why the license number matters. License 92, Swinerton Builders, was current and active through Aug 31, 2027, with 18 classifications, a $25,000 contractor's bond and no complaints disclosed.
- Washington L&I: Merit Electric Inc of Lake Stevens came back as an active electrical contractor through Jan 23, 2028. Its bond field was empty, since that dataset leaves bonds out.
How to check a contractor license in Claude
- Open Claude's listing for the Firecrawl connector and choose Connect.
- Log into Firecrawl, or create a free account at that point, then pick the team and grant access.
- In the chat composer, press +, choose Connectors and flip the Firecrawl switch.
A request in everyday language is enough:
Use Firecrawl Alexandria to look up California CSLB license 92 and
tell me its status, classifications, bond and workers' comp, and
whether the board discloses any complaints.How to check a contractor license in ChatGPT
- Install ChatGPT's Firecrawl plugin.
- ChatGPT asks you to sign in to Firecrawl; if you have no account, sign up in advance.
- Lead with
@firecrawlin the message; without it, ChatGPT answers on its own and skips the license boards.
@firecrawl Search Arizona ROC contractor licenses in Firecrawl
Alexandria for "[business name]" and show each license's status,
classification, bonds and complaint history.How to check a contractor license in Claude Code, Cursor and other AI agents
For licensing checks inside an editor or terminal, register the Firecrawl MCP server; Firecrawl Alexandria comes with it. Registration opens a browser tab where you log into your Firecrawl account.
- Claude Code:
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth, and then authenticate from the/mcpmenu. - Cursor and clients configured with JSON: paste this into the MCP settings.
{
"mcpServers": {
"firecrawl": {
"url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
}
}
}The agent then has firecrawl_search with sources: ["alexandria"] to locate a licensing provider, firecrawl_find_tools to read its inputs, and firecrawl_scrape to run the lookup. Prices only appear when firecrawl_find_tools is called with includeCosts: true, which is worth requesting when you want to see the cost up front. This setup suits batch work, such as checking every subcontractor on a bid list.
How to check a contractor license with the Firecrawl API
For a vendor onboarding script or a bid review tool, run the licensing tools straight from Python after pip install firecrawl-py:
from firecrawl import Firecrawl
app = Firecrawl(api_key="fc-YOUR_API_KEY")
def provider_data(result):
item = result.alexandria[0]
if item.error: # a provider can fail without returning data
raise RuntimeError(f"{item.provider}: {item.error.code} {item.error.message}")
return item.data
# Find license numbers by business name, 5 credits
names = app.scrape(
alexandria={
"provider": "cslb-ca-gov",
"capability": "licenses/search_contractors_by_name",
"options": {"name": "Swinerton"},
}
)
for row in provider_data(names)["results"]:
print(row["license_number"], row["business_name"], row["status"])
# Read one license in full, 5 credits
lic = app.scrape(
alexandria={
"provider": "cslb-ca-gov",
"capability": "licenses/get_license",
"options": {"license_number": "92"},
}
)
record = provider_data(lic)
print(record["status_text"], record["expire_date"])
for bond in record["bonds"]:
print(bond["type"], bond["amount"], bond["surety"])
# Washington registrations, 5 credits
wa = app.scrape(
alexandria={
"provider": "data-wa-gov",
"capability": "licenses/search_contractors",
"options": {"name": "merit electric", "limit": 3},
}
)
print(provider_data(wa))Calls from code use the API key from your Firecrawl account; keyless access doesn't include Firecrawl Alexandria. For options and response formats, read the Firecrawl docs.
What it costs
There is no charge for discovering licensing tools or checking their prices. A lookup is 5 Firecrawl credits, and every answer lists the tools used and their charge. A typical California check (name search, license record and complaint disclosure) is 15 Firecrawl credits; the live test behind this guide used 25 Firecrawl credits across California, Washington and Colorado. Plan details live on Firecrawl pricing, and prices can change.
Limits to know
- Coverage is partial. The tools cover California, Washington, Oregon, Florida and Arizona, Colorado's state trade licenses and the City of Pittsburgh. Colorado general contractors are licensed by cities and counties and aren't in the Colorado data. For any other state, use that board's own lookup.
- Some records lack bonds or insurance. The Washington dataset leaves bonds out, and the Colorado and Pittsburgh data publish neither bonds nor insurance. Oregon's data lists active licenses only, so an expired or suspended Oregon license comes back as not found. Colorado's data is a daily extract, so a license can still read "Active" after its expiry date. Open DORA's verification page before relying on it.
- Licensing is one check among several. A record confirms the contractor is allowed to do the work. It doesn't vouch for their workmanship, and it isn't legal advice. Get a written contract and check references too.
Related guides
- How to use ChatGPT to check BBB complaints: read customer complaints against the same business.
- California CSLB in Firecrawl Alexandria: the license record, name and location search, personnel list and complaint disclosure tools.
- Public records providers: other licensing boards and government registries your assistant can query.
Use Firecrawl in your agent
Add Firecrawl to ChatGPT, Claude, Cursor and more in one click.
Frequently Asked Questions
How can I tell if a contractor is licensed?
Ask the contractor for their license number, then look it up on the licensing board of the state where the work will happen. The record shows whether the license is active, when it expires and what kind of work it covers. With Firecrawl Alexandria, an AI assistant can do that lookup for California, Washington, Oregon, Florida and Arizona, for Colorado electrical and plumbing licenses, and for City of Pittsburgh contractor licenses.
How does a CSLB license lookup work?
The California Contractors State License Board lets anyone search by license number, business name or personnel name on its Check a License page. The license detail shows status, classifications, the contractor's bond, workers' compensation coverage and a link to complaint disclosures when the board has any to show. Firecrawl Alexandria has CSLB tools for the license record, name search and complaint disclosures, so an assistant can return the record and the disclosures in one answer.
What should I verify besides the license status?
Check that the license classification matches the job, that the bond and insurance are current, and whether the board lists complaints or discipline. Also confirm that the license number and business name on the record match the ones on your contract, since a similar name can belong to a different company.
Does an active license mean the contractor does good work?
An active license does not mean the contractor does good work, because it only shows they met the state's requirements and are allowed to work. It says nothing about the quality of past jobs. Read reviews, ask for references and get a written contract. This guide is general information, not legal advice.
What does a contractor license lookup cost with Firecrawl?
Browsing the licensing tools and their prices is free. Each license tool here costs 5 Firecrawl credits a call, so a name search plus the full license record is 10 Firecrawl credits, and adding the complaint check makes it 15, though prices can change.
What is Firecrawl Alexandria?
Firecrawl Alexandria is Firecrawl's library of 400+ data providers that AI assistants and agents can call directly, from public sources and licensed publishers such as Fiscal.ai, Benzinga and Apollo to Firecrawl's own Research, Developer and Government indexes. Connect Firecrawl to ChatGPT, Claude, Cursor or another agent, and it finds the right provider for your question, shows the price of each tool and returns the record from the source. It needs a Firecrawl account, signed in through the connector, plugin or MCP sign-in, or an API key; keyless connections don't include it. Finding tools is free; running one uses Firecrawl credits.