# RefurbSitter MCP

Connect your MCP client and use tools to look up configurations, manage watches, and configure alerts.

## Connect in one step

Claude Code: run this command, then run `/mcp` to sign in.

```bash
claude mcp add --transport http refurbsitter https://refurbsitter.com/api/mcp
```

Claude.ai and Claude Desktop: open Plugins → Add → Add custom connector, paste this URL, keep Claude’s published identity and sign in.

```text
https://refurbsitter.com/api/mcp
```

ChatGPT: open Plugins → Add → Add custom MCP server, paste this URL, keep OAuth selected and sign in. If that option is missing, turn on developer mode in ChatGPT settings first.

```text
https://refurbsitter.com/api/mcp
```

VS Code: [install RefurbSitter in VS Code](https://vscode.dev/redirect/mcp/install?name=refurbsitter&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Frefurbsitter.com%2Fapi%2Fmcp%22%7D), then choose Start and sign in. Cursor does not support this sign-in yet. Use an [API key in Cursor](#cursor).

You approve the connection on a RefurbSitter page. No client ID or key is needed. Each connection counts against your plan’s key limit. Revoke it from [Dashboard → Agent keys](/dashboard/settings#agent-keys-title).

## Connect with an API key

The server receives JSON-RPC 2.0 over Streamable HTTP at `https://refurbsitter.com/api/mcp`. To use a key, send an `Authorization: Bearer YOUR_API_KEY` header.

To get a key without a browser, use `POST /api/agent/v1/signup` to request a code. Send the code to `POST /api/agent/v1/signup/verify`. See the [email-code signup flow](/docs/api#signup).

Without an Authorization header, `initialize` and `tools/list` return HTTP 401 with an OAuth challenge.

Keep the key in your client’s secret store or private configuration.

## Claude Code

```bash
claude mcp add --transport http refurbsitter https://refurbsitter.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

## Cursor

Add the server to `.cursor/mcp.json`. Keep the file out of version control if it contains a key.

```json
{
  "mcpServers": {
    "refurbsitter": {
      "type": "http",
      "url": "https://refurbsitter.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## Claude Desktop

Add this entry to your local `claude_desktop_config.json` and restart Claude Desktop. The `mcp-remote` bridge runs through `npx`.

```json
{
  "mcpServers": {
    "refurbsitter": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://refurbsitter.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}
```

## VS Code

Add this to `.vscode/mcp.json`. VS Code prompts you for the key.

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "refurbsitter-key",
      "description": "RefurbSitter API key",
      "password": true
    }
  ],
  "servers": {
    "refurbsitter": {
      "type": "http",
      "url": "https://refurbsitter.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:refurbsitter-key}"
      }
    }
  }
}
```

## Generic Streamable HTTP client

Use POST with `Content-Type: application/json` and accept JSON responses. The server supports protocol versions `2025-11-25` and `2025-06-18`. It responds with JSON and does not open a GET event stream.

```bash
curl -sS 'https://refurbsitter.com/api/mcp' \
  -H "Authorization: Bearer $REFURBSITTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}'
```

Send `notifications/initialized` without an `id` after initialization. On subsequent requests, send the negotiated version in `MCP-Protocol-Version`. Use `tools/list` for input schemas and `tools/call` with `params.name` and `params.arguments`.

## Tools

| Tool | Access | Required arguments | Optional arguments | What it does |
| --- | --- | --- | --- | --- |
| `get_account` | Read-only | None | None | Read the account, effective plan, entitlements, and watch quota. |
| `list_catalog` | Read-only | None | None | List watchable product families and configurations. |
| `list_watches` | Read-only | None | None | List the account's restock watches. Spot or higher. |
| `create_watch` | Write | `channels` | `config_id`, `model_family`, `chip_pattern`, `cpu_cores_min`, `gpu_cores_min`, `ram_gte`, `ram_lte`, `ssd_gte`, `screen_size`, `requires_10gb_ethernet` | Create a watch using a catalog ID or the applicable manual fields. Spot or higher. |
| `delete_watch` | Write | `id` | None | Delete a watch using the ID from list_watches. Send a string or a safe integer. Invalid IDs, missing watches, and watches outside the account return watch_not_found. Spot or higher. |
| `set_webhook` | Write | None | `webhook_url`, `rotate_secret` | Set or clear a webhook URL, or rotate its secret. Hunt, Fleet, and Reseller. |
| `create_checkout_link` | Write | `plan` | None | Create a Stripe Checkout link for the account owner. |

For `create_watch`, pass a `config_id` from `list_catalog` and a nonempty `channels` array. If you omit the ID, supply `model_family` and the applicable configuration fields. Read `allowed_channels` from `get_account`. See [plan access](/docs/api#plans) and [setting a webhook](/docs/webhooks#configure).

Tool calls return a JSON string in `result.content[0].text`. Check `result.isError` before using the result. Protocol or authentication failures can return a top-level JSON-RPC `error`. The [REST API error and rate limit reference](/docs/api#errors) describes the shared operation errors and limits.

## Example prompts

- “Show my RefurbSitter plan, remaining watch slots, and allowed alert channels.”
- “List Mac Studio configurations with at least 64 GB of RAM.”
- “Find a Mac Studio M5 Max with 48 GB RAM and 512 GB storage in the catalog and create an email watch for it.”
- “Show my watches and ask me which one to delete.”
- “Create a Hunt Pass checkout link and give it to me to open.”

[Contact support](/contact) · [Privacy policy](/privacy) · [Terms](/terms)
