Search contractor licenses
search_licensesSearch contractor licenses (California by default; pass state for others) three ways. (1) By business name, as written on a quote, invoice, truck or website: typos, word forms (plumber/plumbing), missing words and Inc/LLC are handled, and other names on the CSLB record are matched too (other_business_names lists the ones that are business names). Each match has a match_level (exact, strong, partial) and says what it matched on. (2) By license number. (3) With no name, by trade and/or city to list licensed contractors. The trade can be a description of the job ("my AC is blowing warm air", "sewage backing up"); read_as says how it was read. Lists: clear licenses only by default, in a shuffled order fixed until the next data refresh, 10 per page, up to 5 pages. Lists are not rankings or recommendations. A name match is not proof of identity, so give the user the license number and ask them to confirm it with the contractor.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_licenses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City or ZIP code, e.g. "Oakland", "Oakland, CA" or "94704". | |
| name | No | Business name or part of it, e.g. "Diamond Plumbing". Leave out to list by trade and/or city. | |
| page | No | For lists: page number, default 1. | |
| work | No | California lists only: a kind of work from city permits, e.g. "water heater", "heat pump", "sewer". Lists only contractors with San Francisco permits for that work in the last five years. | |
| state | No | Two-letter state code. Default CA. Others with data: CO, CT, FL, IL, KS, MN, NY, OR, PA, TX, VA, WA. | |
| trade | No | Trade in plain words or a CSLB code, e.g. "plumbing", "furnace", "water heater", "sewer line", "C-36". | |
| status | No | For lists: clear (default) or all, which includes suspended and other licenses. | |
| license | No | CSLB license number, if you have one. |