How to check a contractor license with ChatGPT, Claude, or any AI assistant

Last updated: Nov 11, 2026

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

SourceWhat you getThe catch
California CSLB Check a LicenseSearch by license number, business name or personnel name, with complaint disclosureThe database goes offline Sunday 8 p.m. to Monday 6 a.m. for maintenance, and name search has fussy spelling rules
Washington L&I VerifyContractor registration, workers' comp account, safety violations and lawsuits against the surety bondWashington only, and you read each record page by hand
Oregon CCB, Florida DBPR and Arizona ROCEach state board's own search for its licensed contractorsOne state per site, each with different search fields and record layouts
Colorado DORA license lookupState licenses for electricians, plumbers and other regulated professionsColorado general contractors are licensed by cities and counties, so this lookup won't show them
An AI assistant with Firecrawl AlexandriaRecords from the California, Washington, Oregon, Florida and Arizona boards, Colorado trade licenses and Pittsburgh city licenses, combinedEach lookup costs Firecrawl credits, and coverage stops at those states and one city

How to check a contractor license with AI, step by step

  1. 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.
  2. 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.
  3. 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.
  4. 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:

ToolWhat it returnsCredits per call
California CSLB license recordBusiness name, address, phone, entity type, issue and expiry dates, the board's status sentence, classifications, every bond block, workers' compensation and miscellaneous actions5
California CSLB name searchUp 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 disclosurePublic cases the board discloses for a license: case number, date, status and number of complaints5
Washington L&I contractor searchConstruction, electrical, plumbing and elevator registrations by name, number, UBI, city, ZIP, type, specialty and status; the full record adds principals, liability insurance and permit signers5
Oregon CCB license searchActive CCB licenses with endorsements, surety bonds, liability insurance and the responsible managing individual, plus Building Codes Division electrical and plumbing licenses5
Florida DBPR license searchLicensees 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 list5
Arizona ROC contractor searchContractors by name, ROC number, classification or city; the license record adds personnel, surety bonds and the public complaint history5
Colorado DORA trade licensesState electrical, plumbing and radon licenses (contractors, masters, journeymen, apprentices) with status, expiry and published discipline. No general contractors, bonds or insurance5
Pittsburgh contractor licensesCity of Pittsburgh general, sign, electrical, HVAC and other licenses with status and term dates. No bonds, insurance or discipline5

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

  1. Open Claude's listing for the Firecrawl connector and choose Connect.
  2. Log into Firecrawl, or create a free account at that point, then pick the team and grant access.
  3. 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

  1. Install ChatGPT's Firecrawl plugin.
  2. ChatGPT asks you to sign in to Firecrawl; if you have no account, sign up in advance.
  3. Lead with @firecrawl in 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 /mcp menu.
  • 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

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.

//
Get started
//
Ready to build?
Start getting web context for free and scale seamlessly as your project expands. No credit card needed.
Are you an AI agent? See setup options