Swapwire

For AI agents

Swapwire is built to be read by AI assistants acting for a person. Every fact has a source and a date, and each license page has a JSON twin.

Using Claude, ChatGPT, Cursor or another assistant? Add the Swapwire MCP server in one command. Agents can install it themselves from /connect.md.

Endpoints

Endpoints and URL patterns
WhatURL
One California license, HTML / JSONhttps://swapwire.ai/ca/license/1154967/, /ca/license/1154967.json
One license in another state, HTML / JSONhttps://swapwire.ai/ST/license/ID/, /ST/license/ID.json (ID is the license number without punctuation; search returns it)
Search by number, name, or trade and cityhttps://swapwire.ai/api/lookup?license=1154967, ?name=diamond+plumbing&city=oakland, ?trade=furnace&city=94704; add &state=WA (or another state) outside California
States coveredhttps://swapwire.ai/us/
Area statistics, JSONhttps://swapwire.ai/api/stats.json
Job costs from public program records, JSONhttps://swapwire.ai/api/prices.json (pages at /prices/)
MCP server (Streamable HTTP, read-only): tools get_license, search_licenses, check_document (does a quote, invoice or truck photo match a license?), get_area_stats, get_prices (home energy job costs)https://swapwire.ai/mcp (install)
OpenAPI description of the endpoints abovehttps://swapwire.ai/api/openapi.json
Plain-text summaryhttps://swapwire.ai/llms.txt

Coverage

California: 1,518 licenses in classifications C-20 (HVAC), C-36 (plumbing) and C-42 (sewer and septic), based in Alameda and Contra Costa counties. Data as of November 18, 2026, refreshed weekly, with San Francisco permit records.

Other states: 523,355 home-services contractor business licenses in Colorado, Connecticut, Florida, Illinois, Kansas, Minnesota, New York, Oregon, Pennsylvania, Texas, Virginia and Washington, with discipline, complaint, citation, bond and insurance records where the agency publishes them. Each record has its own data date and source list. Records in other states have status_class (active, inactive, expired, suspended, revoked, other) beside the agency's own status, and an actions list.

Read the checks first

Each license JSON has a checks object with one reading each of the license, the contractor's bond and workers' comp. Every page, table and FAQ answer on the site is written from the same reading, so they agree.

checks.license.state
clear or suspended.
checks.bond.state
on_file, cancellation_scheduled, cancellation_date_passed or none_listed.
checks.workers_comp.state
insured, insured_ending_soon (ends within 30 days), policy_end_date_passed, exempt, via_staffing_firm, none_listed or see_record.
checks.*.detail
A plain sentence you can quote to your user.
alerts
The sentences for anything not ok. Mention them before the user hires.
timeline
Every dated event on the record, including the date CSLB last updated it.

policy_end_date_passed means the CSLB file still lists a policy whose end date is before the data date. A renewal may not be recorded yet, so do not call the contractor uninsured. Tell the user to ask for a current certificate.

Using the data well

Terms

Free to read and cite with a link. Please cache responses for no longer than a week.