California contractor license checks (CSLB): status, bond, workers' comp, quote matching.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Check whether a contractor's quote, invoice, contract, business card, ad or truck photo matches a California license in this dataset. Send the document as text, as a PNG or JPEG image (base64), or both, plus the license number to check against (if the text shows a license number from the dataset, it is used). Returns a verdict (consistent, number_only, mismatch or unclear; number_only means only the license number matched, which anyone could copy), whether the business name and license number on the document match the record, whether the work described falls outside the license's classifications, and the license's status, bond and workers' comp checks. The verdict is a reading of the document, not proof. The document is read by TypeSafe's Jev model and is not stored by Swapwire; remove a homeowner's personal details before sending if you can.
The document's text, e.g. a pasted quote or ad. Up to 20,000 characters.
A photo or scan of the document, base64-encoded PNG or JPEG, up to 5 MB.
Format of image_base64, if it can't be detected.
CSLB license number to check against, digits only. Optional if the text shows it.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http contractor-licenses https://swapwire.ai/mcp
Check whether a contractor's quote, invoice, contract, business card, ad or truck photo matches a California license in this dataset. Send the document as text, as a PNG or JPEG image (base64), or both, plus the license number to check against (if the text shows a license number from the dataset, it is used). Returns a verdict (consistent, number_only, mismatch or unclear; number_only means only the license number matched, which anyone could copy), whether the business name and license number on the document match the record, whether the work described falls outside the license's classifications, and the license's status, bond and workers' comp checks. The verdict is a reading of the document, not proof. The document is read by TypeSafe's Jev model and is not stored by Swapwire; remove a homeowner's personal details before sending if you can.
| Argument | Type | Description |
|---|---|---|
| text | string | The document's text, e.g. a pasted quote or ad. Up to 20,000 characters. |
| image_base64 | string | A photo or scan of the document, base64-encoded PNG or JPEG, up to 5 MB. |
| image_format | string | Format of image_base64, if it can't be detected. |
| license_number | string | CSLB license number to check against, digits only. Optional if the text shows it. |
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The document's text, e.g. a pasted quote or ad. Up to 20,000 characters."
},
"image_base64": {
"type": "string",
"description": "A photo or scan of the document, base64-encoded PNG or JPEG, up to 5 MB."
},
"image_format": {
"enum": [
"png",
"jpg"
],
"type": "string",
"description": "Format of image_base64, if it can't be detected."
},
"license_number": {
"type": "string",
"description": "CSLB license number to check against, digits only. Optional if the text shows it."
}
},
"additionalProperties": false
}Counts for each county and trade in the dataset: licenses, how many carry workers' comp insurance or are exempt, how many have a suspension code, median years licensed and how many were issued in the last two years. Useful for saying whether one contractor's record is typical.
| Argument | Type | Description |
|---|---|---|
| trade | string | Optional trade filter. |
| county | string | Optional county filter. |
{
"type": "object",
"properties": {
"trade": {
"enum": [
"HVAC",
"Plumbing",
"Sewer and septic"
],
"type": "string",
"description": "Optional trade filter."
},
"county": {
"enum": [
"Alameda",
"Contra Costa"
],
"type": "string",
"description": "Optional county filter."
}
},
"additionalProperties": false
}Full record for one California contractor license by number: status, classifications, bond, workers' comp, years licensed, how it compares with similar licenses nearby, and the CSLB source link. Use this when you have a license number, or after search_licenses to read a match in full.
| Argument | Type | Description |
|---|---|---|
| license_number* | string | CSLB license number, digits only, e.g. "1154967". |
{
"type": "object",
"required": [
"license_number"
],
"properties": {
"license_number": {
"type": "string",
"description": "CSLB license number, digits only, e.g. \"1154967\"."
}
},
"additionalProperties": false
}Search California contractor licenses 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.
| Argument | Type | Description |
|---|---|---|
| city | string | City or ZIP code, e.g. "Oakland", "Oakland, CA" or "94704". |
| name | string | Business name or part of it, e.g. "Diamond Plumbing". Leave out to list by trade and/or city. |
| page | integer | For lists: page number, default 1. |
| trade | string | Trade in plain words or a CSLB code, e.g. "plumbing", "furnace", "water heater", "sewer line", "C-36". |
| status | string | For lists: clear (default) or all, which includes suspended and other licenses. |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
| license |
| string |
| CSLB license number, if you have one. |
{
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "City or ZIP code, e.g. \"Oakland\", \"Oakland, CA\" or \"94704\"."
},
"name": {
"type": "string",
"description": "Business name or part of it, e.g. \"Diamond Plumbing\". Leave out to list by trade and/or city."
},
"page": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "For lists: page number, default 1."
},
"trade": {
"type": "string",
"description": "Trade in plain words or a CSLB code, e.g. \"plumbing\", \"furnace\", \"water heater\", \"sewer line\", \"C-36\"."
},
"status": {
"enum": [
"clear",
"all"
],
"type": "string",
"description": "For lists: clear (default) or all, which includes suspended and other licenses."
},
"license": {
"type": "string",
"description": "CSLB license number, if you have one."
}
},
"additionalProperties": false
}