Connect Swapwire to your AI
Add Swapwire’s MCP server and your assistant can check a California contractor’s license while you talk to it: status, bond, workers’ comp, and whether a quote matches the license. Free, read-only, no account or key.
Server URL: https://swapwire.ai/mcp · Streamable HTTP · 1,518 East Bay HVAC, plumbing and sewer licenses, data as of November 18, 2026
Install in every agent with one command
Finds the AI tools on your computer (Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Claude Desktop and about 20 more) and adds Swapwire to the ones you pick. Needs Node.js. It uses add-mcp, an open-source installer from Neon.
npx add-mcp https://swapwire.ai/mcp --name swapwire -g
Or ask your agent to install it
Paste this into Claude Code, Cursor, Codex or any agent that can run commands:
Read https://swapwire.ai/connect.md and add the Swapwire MCP server to this agent.
Install in one app
Claude Code
claude mcp add --transport http --scope user swapwire https://swapwire.ai/mcp
Drop --scope user to add it to the current project only. Start a new session, then run /mcp to see it.
Claude app
On claude.ai and in Claude Desktop:
- Open Customize → Connectors, select +, then Add custom connector.
- Name it Swapwire, paste
https://swapwire.ai/mcpand select Add. There is nothing to sign in to. - In a chat, turn on Swapwire from the connectors menu.
Free plans allow one custom connector. On Team and Enterprise plans an owner adds it for the organization.
ChatGPT
- On chatgpt.com, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
- Back in Connectors, select Create. Name it Swapwire, paste
https://swapwire.ai/mcp, choose no authentication, and create it.
Developer mode is on the web only, and which plans have it changes; see OpenAI’s help pages if the setting is missing.
Cursor
Or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"swapwire": {
"url": "https://swapwire.ai/mcp"
}
}
}VS Code
Or add this to .vscode/mcp.json:
{
"servers": {
"swapwire": {
"type": "http",
"url": "https://swapwire.ai/mcp"
}
}
}Codex
codex mcp add swapwire --url https://swapwire.ai/mcp
The Codex CLI, the IDE extension and the ChatGPT desktop app share this setting.
Gemini CLI
gemini mcp add --transport http -s user swapwire https://swapwire.ai/mcpWindsurf
Add this to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"swapwire": {
"serverUrl": "https://swapwire.ai/mcp"
}
}
}Other
Add a remote MCP server with the URL https://swapwire.ai/mcp, transport Streamable HTTP (sometimes called “HTTP”), and no authentication.
No MCP? The same data is a plain HTTP API, described in OpenAPI for GPT actions and agent frameworks.
Swapwire is listed in the official MCP Registry as ai.swapwire/contractor-licenses.
What your assistant can do
| Tool | Ask your assistant | What comes back |
|---|---|---|
| search_licenses | “Is Diamond Plumbing in Concord licensed?” “Find a licensed plumber near 94704” “My AC is blowing warm air. Who can fix it in Oakland?” | Matching licenses, each with how well the name matched; or a shuffled list of clear licenses for a trade and city. |
| get_license | “Is license 1019643 active? Is it bonded and insured?” | The full record: status, bond, workers' comp, plain-sentence alerts, and a link to the CSLB record. |
| check_document | “Does this quote match the contractor’s license? (with a photo or the text)” | consistent, number_only, mismatch or unclear, with reasons: the business name, the license number, and work the license doesn't cover. |
| get_area_stats | “Is it normal for a plumber in Alameda County to be exempt from workers’ comp?” | Counts by county and trade: insured, exempt, suspended, years licensed. |
Every answer carries the data date and a link to the live CSLB record. A name match is not proof of identity, and no result means the license is not in this dataset, not that the contractor is unlicensed. See For AI agents for field-by-field notes.
Check that it works
Ask your assistant: “Use Swapwire to check license 1019643.” Or list the tools from a terminal:
curl -s https://swapwire.ai/mcp -H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Limits
- Coverage: C-20 (HVAC), C-36 (plumbing) and C-42 (sewer and septic) licenses based in Alameda and Contra Costa counties. Refreshed weekly.
- 60 requests a minute from one address. For more, write to hello@swapwire.ai.
- Read-only: no tool changes anything. Documents sent to
check_documentare read by TypeSafe’s Jev model and not stored by Swapwire.