# SW Toolbox MCP

Local MCP hub for [SW Toolbox](https://tools.sw-commercial.com/mcp). Agents call file tools on your machine instead of writing a script. Files stay on the machine.

**Needs [SW Toolbox Pro](https://buy.polar.sh/polar_cl_uMhlIAo26mDsjdNfzVese4b6q2oNVXdy1hPZX0B60JR) ($15 once).** Set `SW_TOOLBOX_KEY` to your Polar `SW-TBX-…` key. Without it, `npx` exits and does not register tools. The websites and the Chrome popup stay free.

## Use with Cursor

```json
{
  "mcpServers": {
    "sw-toolbox": {
      "command": "npx",
      "args": ["-y", "github:simonwong201293/tools-mcp"],
      "env": {
        "SW_TOOLS_GROUPS": "images",
        "SW_TOOLBOX_KEY": "SW-TBX-your-pro-key"
      }
    }
  }
}
```

`SW_TOOLS_GROUPS` is a comma list: `images`, `pdf`, `data`.

## Groups

| Group | Tools |
|---|---|
| images | compress_image, convert_image, resize_image, strip_exif, heic_convert |
| pdf | merge_pdf, split_pdf, images_to_pdf |
| data | format_json, view_csv, make_qr, color_palette |

## HTTP MCP (`serve`)

Same Pro key required.

```bash
SW_TOOLBOX_KEY=SW-TBX-your-pro-key npx github:simonwong201293/tools-mcp serve
```

Binds **127.0.0.1:17321**:

- `GET /health` — Agent panel probe
- `POST /shutdown` — Agent panel Stop
- `/mcp` — Streamable HTTP MCP

Chrome **Start hub** still uses this after `install-host` and a pasted Pro key.

## Mint keys (owner)

```bash
node scripts/mint-pro-key.mjs 1
node scripts/mint-pro-key.mjs 1 20
```

Keep `PRO_SECRET` in sync with `src/license.ts` and `web-tools-ext/src/lib/mcp/license.ts`.

## Develop

```bash
npm install
npm run build
SW_TOOLBOX_KEY=SW-TBX-your-pro-key node dist/index.js
```