# Add the Swapwire MCP server

You are an AI agent. Your user wants the Swapwire MCP server added to the agent or app you are running in, so you can check California contractor licenses for them.

- Server URL: https://swapwire.ai/mcp
- Transport: Streamable HTTP. No authentication, no API key, read-only.
- Server name to use: `swapwire`

## Steps

1. Work out which client you are running in.
2. Run the command for it below, or merge the JSON into its config file. Keep every server already in the file; add `swapwire` beside them. Create the file if it does not exist.
3. Check the server answers (this needs no client):

```
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"}'
```

   A reply listing `search_licenses`, `get_license`, `check_document` and `get_area_stats` means it works.
4. Tell your user what you added and where, and that most clients need a restart or a new session before the tools appear.

If you are not sure which client you are in, or it is not listed, use the installer, which asks which agents to add it to: `npx add-mcp https://swapwire.ai/mcp --name swapwire -g`. Ask your user before running it with `--all` or `-y`.

## Commands and config by client

| Client | How |
|---|---|
| Claude Code | `claude mcp add --transport http --scope user swapwire https://swapwire.ai/mcp` |
| Codex (CLI, IDE, ChatGPT desktop) | `codex mcp add swapwire --url https://swapwire.ai/mcp` |
| Gemini CLI | `gemini mcp add --transport http -s user swapwire https://swapwire.ai/mcp` |
| Cursor | Merge into `~/.cursor/mcp.json` (or `.cursor/mcp.json` in the project) |
| VS Code (Copilot agent mode) | Merge into `.vscode/mcp.json` |
| Windsurf | Merge into `~/.codeium/windsurf/mcp_config.json` |
| Claude (claude.ai, Claude Desktop) | Your user adds it: Customize > Connectors > + > Add custom connector, URL above |
| ChatGPT | Your user adds it: Settings > Apps & Connectors > Advanced settings > Developer mode, then Create, URL above, no authentication |

Cursor:

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

VS Code:

```json
{
  "servers": {
    "swapwire": {
      "type": "http",
      "url": "https://swapwire.ai/mcp"
    }
  }
}
```

Windsurf:

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

## Using the tools

- `search_licenses`: Matching licenses, each with how well the name matched; or a shuffled list of clear licenses for a trade and city. Example asks: Is Diamond Plumbing in Concord licensed?; Find a licensed plumber near 94704; My AC is blowing warm air. Who can fix it in Oakland?
- `get_license`: The full record: status, bond, workers' comp, plain-sentence alerts, and a link to the CSLB record. Example asks: Is license 1019643 active? Is it bonded and insured?
- `check_document`: consistent, number_only, mismatch or unclear, with reasons: the business name, the license number, and work the license doesn't cover. Example asks: Does this quote match the contractor’s license? (with a photo or the text)
- `get_area_stats`: Counts by county and trade: insured, exempt, suspended, years licensed. Example asks: Is it normal for a plumber in Alameda County to be exempt from workers’ comp?

Coverage: 1,518 C-20, C-36 and C-42 licenses in Alameda and Contra Costa counties, California, data as of 2026-11-18. A name match is not proof of identity: give your user the license number and ask them to confirm it with the contractor. No result means not in this dataset, not unlicensed. More: https://swapwire.ai/agents/
