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/mcpClaude.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/mcpChatGPT: 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/mcpVS 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
| 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 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.”