Integration

Connect DomainCare to your AI tools

DomainCare provides a hosted MCP server that lets Claude, Cursor, and Codex manage your domains conversationally — query health status, add new domains, trigger rechecks, and more, all from your AI coding environment.

Endpoint

https://domaincare.io/api/mcp

The server uses Streamable HTTP transport (MCP spec 2025-03-26). Connect with one-click OAuth — point your client at the URL and sign in with your DomainCare account; no API key to paste. An X-Api-Key header still works for headless setups.

Connect with OAuth in seconds

Pick your AI tool, point it at the endpoint, and sign in — no API key to paste. The browser consent screen requests mcp:read, mcp:write, and mcp:full scopes; approve only what you need.

Claude Desktop — Settings → Connectors → Add custom connector
1. Open Claude Desktop Settings → Connectors → Add custom connector
2. Name: DomainCare
3. Remote MCP server URL: https://domaincare.io/api/mcp
4. Click Connect → sign in → approve access → done
Claude Code (CLI)
# Add without a key (omit --header) so it uses OAuth:
claude mcp add --transport http domaincare https://domaincare.io/api/mcp

# Then in a session: /mcp → domaincare → Authenticate → sign in
Cursor — ~/.cursor/mcp.json (URL only, no headers)
{
  "mcpServers": {
    "domaincare": {
      "url": "https://domaincare.io/api/mcp"
    }
  }
}

Then open Settings → MCP and click Needs login to sign in.

Codex CLI — ~/.codex/config.toml
# ~/.codex/config.toml ('codex mcp add' is stdio-only, so edit the file)
[mcp_servers.domaincare]
url = "https://domaincare.io/api/mcp"

# Then run the browser sign-in:
codex mcp login domaincare

No browser? Use an API key (headless / CI)

For CI or a client that can't sign in, authenticate with a key from Settings → API Keys via the X-Api-Key header — replace dc_your_key_here.

Claude Code — API key
claude mcp add --transport http domaincare https://domaincare.io/api/mcp \
  --header "X-Api-Key: dc_your_key_here"
Cursor — API key
{
  "mcpServers": {
    "domaincare": {
      "url": "https://domaincare.io/api/mcp",
      "headers": { "X-Api-Key": "dc_your_key_here" }
    }
  }
}

Or let your AI set it up

Don't want to touch a config file? Paste this prompt into Claude Code, Cursor, Codex, or any agentic coding tool — it'll wire up the connection itself, OAuth-first, and only ask you for an API key if it can't sign in through the browser.

Paste into your AI agent
Set up the DomainCare MCP server in this tool so you can manage my domains.

It's a hosted Streamable HTTP MCP server at: https://domaincare.io/api/mcp
It supports OAuth — prefer signing in over an API key whenever the client can.

- If you are Claude Code, run (no key — this triggers OAuth):
  claude mcp add --transport http domaincare https://domaincare.io/api/mcp
  then tell me to run /mcp → domaincare → Authenticate and sign in.
- If you are Cursor, add to its MCP config (URL only, no headers) and tell me to
  click "Needs login" in Settings → MCP:
  { "mcpServers": { "domaincare": { "url": "https://domaincare.io/api/mcp" } } }
- If you are Codex, add to ~/.codex/config.toml then run "codex mcp login domaincare":
  [mcp_servers.domaincare]
  url = "https://domaincare.io/api/mcp"

If the client genuinely can't do a browser sign-in, ask me for an API key (from
domaincare.io → Settings → API Keys; needs an active paid plan) and send it as the
"X-Api-Key" header.
Then confirm it works by calling list_domains and showing me my domains.

What your AI can do

Full parity with the REST API — 23 tools spanning domains, checks, per-check overrides, and status pages, across read, write, and destructive access levels.

ToolAccess
list_domains

List all domains in your account with current health status.

read
get_domain

Fetch details and the latest check results for one domain.

read
get_checks

Retrieve individual check results (SSL, DNS, uptime, etc.) for a domain.

read
list_events

Query the event log — status changes, alerts, recoveries.

read
add_domain

Add a new domain to your account and start checks immediately.

write
trigger_recheck

Force an immediate recheck on a domain without waiting for the schedule.

write
pause_domain

Pause all checks on a domain (alerts are suppressed while paused).

write
resume_domain

Resume checks on a paused domain.

write
delete_domain

Permanently remove a domain and all its history from your account.

full
update_domain

Enable or disable specific check types on a domain.

write
get_check_overrides

Read per-check settings: mute, interval, event toggles, severity.

read
update_check_overrides

Tune a check's mute, interval, per-event toggles, and severity overrides.

write
reset_check_overrides

Reset a check's overrides back to defaults.

full
list_status_pages

List the status pages in your account.

read
get_status_page

Get a status page's domains, layout, and publish state.

read
create_status_page

Create a status page for one or more domains.

write
update_status_page

Update a status page's title, slug, domains, or layout.

write
publish_status_page

Publish a status page.

write
set_status_page_custom_domain

Attach or verify a custom domain for a status page.

write
unpublish_status_page

Take a published status page offline without deleting it.

write
delete_status_page

Delete a status page.

full
get_status_page_custom_domain

Check a status page's custom-domain attachment and verification state.

read
delete_status_page_custom_domain

Detach a custom domain from a status page.

full

Manage your domains from your AI environment

Start a free trial, add your domains, and connect Claude or Cursor in under two minutes.