developers

REST API & MCP

Programmatic access to your watchlist — scripts, CI pipelines, and AI assistants (Cursor, Claude Desktop, ChatGPT). Requires a Pro plan or higher.

Base URL

https://wwbodpkkqiagumervyjt.supabase.co/functions/v1/api-v1

Authentication

Send your API key in the x-api-key header on every request. Generate a key in Settings → Developer API after upgrading to Pro.

curl -H "x-api-key: vac_YOUR_KEY_HERE" \
  https://wwbodpkkqiagumervyjt.supabase.co/functions/v1/api-v1/domains

401

Invalid or missing API key

403

Free plan — upgrade to Pro for API access

429

Rate limit exceeded (includes reset_at)

Rate limits

Plan	Requests/day
Pro	1,000
Business	5,000
Enterprise	Unlimited

REST endpoints

GET

/domains

List all domains on your watchlist.

POST

/domains

Bulk add domains. Body: `{ "domains": ["a.com", "b.io"] }` (max 500 per request).

DELETE

/domains/{name}

Remove a domain from your watchlist (soft delete).

GET

/check/{domain}

Live RDAP availability check for a single domain.

POST /domains response: { added, skipped_duplicates, rejected_over_limit, remaining_quota }

MCP server

Vacato exposes an MCP (Model Context Protocol) server over Streamable HTTP. Connect from Cursor or Claude Desktop to manage your watchlist in plain language.

Available tools

check_domain

list_watchlist

add_domains

remove_domain

Cursor / Claude Desktop config

{
  "mcpServers": {
    "vacato": {
      "type": "http",
      "url": "https://wwbodpkkqiagumervyjt.supabase.co/functions/v1/api-v1/mcp",
      "headers": {
        "x-api-key": "vac_YOUR_KEY_HERE"
      }
    }
  }
}

Replace vac_YOUR_KEY_HERE with your API key. Endpoint: POST https://wwbodpkkqiagumervyjt.supabase.co/functions/v1/api-v1/mcp