Skip to main content

RefurbSitter MCP

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

View Markdown

Connect in one step

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

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.

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.

https://refurbsitter.com/api/mcp

VS Code: install RefurbSitter in VS Code, then choose Start and sign in. Cursor does not support this sign-in yet. Use an API key in 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.

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.

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

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.

{
  "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.

{
  "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.

{
  "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.

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

ToolAccessRequired argumentsOptional argumentsWhat it does
get_accountRead-onlyNoneNoneRead the account, effective plan, entitlements, and watch quota.
list_catalogRead-onlyNoneNoneList watchable product families and configurations.
list_watchesRead-onlyNoneNoneList the account's restock watches. Spot or higher.
create_watchWritechannelsconfig_id, model_family, chip_pattern, cpu_cores_min, gpu_cores_min, ram_gte, ram_lte, ssd_gte, screen_size, requires_10gb_ethernetCreate a watch using a catalog ID or the applicable manual fields. Spot or higher.
delete_watchWriteidNoneDelete 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_webhookWriteNonewebhook_url, rotate_secretSet or clear a webhook URL, or rotate its secret. Hunt, Fleet, and Reseller.
create_checkout_linkWriteplanNoneCreate 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 and setting a webhook.

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 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 · Privacy policy · Terms