<!-- Connect Swapwire to your AI (MCP) | Swapwire | https://swapwire.ai/connect/ -->

[Home](https://swapwire.ai/) / [For AI agents](https://swapwire.ai/agents/) / Connect

# 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](https://nodejs.org/). It uses [add-mcp](https://github.com/neondatabase/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:

1. Open **Customize → Connectors**, select **+**, then **Add custom connector**.
2. Name it Swapwire, paste `https://swapwire.ai/mcp` and select **Add**. There is nothing to sign in to.
3. 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

1. On chatgpt.com, open **Settings → Apps & Connectors → Advanced settings** and turn on **Developer mode**.
2. 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

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=swapwire&config=eyJ1cmwiOiAiaHR0cHM6Ly9zd2Fwd2lyZS5haS9tY3AifQ%3D%3D)

Or add this to `~/.cursor/mcp.json`:

```
{
  "mcpServers": {
    "swapwire": {
      "url": "https://swapwire.ai/mcp"
    }
  }
}
```

### VS Code

[Add to VS Code](https://vscode.dev/redirect/mcp/install?name=swapwire&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//swapwire.ai/mcp%22%7D)

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/mcp
```

### Windsurf

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](https://swapwire.ai/api/openapi.json) for GPT actions and agent frameworks.

Swapwire is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=ai.swapwire) as `ai.swapwire/contractor-licenses`.

## What your assistant can do

Swapwire MCP tools

| 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](https://swapwire.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](mailto:hello@swapwire.ai).
- Read-only: no tool changes anything. Documents sent to `check_document` are read by TypeSafe’s Jev model and not stored by Swapwire.
