Expired Domains MCP | Karma.Domains

MCP server for expired domains

Connect Karma.Domains to ChatGPT, Claude, Cursor, VS Code, or another MCP client — and find a domain in plain language. The same auctions, expired, backorder, and buy-now data you use in the app, plus saved filters, notes and tags, guest share links, and SEO enrich — all from chat.

• 400k+ New domains daily
• 40+ Data sources
• 90+ Search filters
• 31 MCP tools
• SEO metrics from Ahrefs, Majestic, Moz, SimilarWeb plus Wayback Machine history

Requires the Pro plan and an API key from Profile → Settings. Same key as the Public API. Treat the key like a password.

Connection

Parameter	Value
URL	https://mcp.karma.domains/mcp
Auth	OAuth (Claude.ai / ChatGPT) or Authorization: Bearer YOUR_API_KEY

ChatGPT

Settings → Plugins → MCP — ChatGPT Plus, Pro, Business, Enterprise, or Edu

1. Open ChatGPT Settings → Plugins → MCP. A paid ChatGPT plan is required — not the free tier.
2. Click Add server. Name it Karma.Domains, choose Streamable HTTP, and paste the MCP URL.
3. Set authentication to OAuth (browser sign-in) or Bearer / Token with your Pro API key. Save, restart if prompted, and keep the server enabled. On the web, enable Developer mode in Settings → Security and login, then add the server from Plugins.

• Name: Karma.Domains
• Type: Streamable HTTP
• URL: https://mcp.karma.domains/mcp
• Auth: OAuth (browser sign-in) or Bearer / Token with YOUR_API_KEY

Claude.ai, ChatGPT, and other OAuth MCP clients open a browser sign-in. Cursor and similar tools still use a Pro API key in the Authorization header.

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json · Claude.ai Connectors

1. Prefer OAuth when available (Claude.ai Connectors and other OAuth MCP clients): add the MCP URL, choose OAuth / sign-in, complete browser login on karma.domains (Pro plan). No API key paste needed.
2. For Claude Desktop with a Pro API key: install Node.js 18+, open the config file for your OS, and use the snippet below.
3. Replace YOUR_API_KEY if you use the key path, save, and restart Claude Desktop (or reconnect the connector after OAuth).

Claude.ai, ChatGPT, and other OAuth MCP clients open a browser sign-in. Cursor and similar tools still use a Pro API key in the Authorization header.

{
  "mcpServers": {
    "karma-domains": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.karma.domains/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

n8n

Workflow editor — MCP Client node

1. Add a node and search for MCP Client.
2. Set Server transport to HTTP Streamable and paste the MCP Endpoint URL.
3. Set Authentication to Bearer Auth, create credentials, and paste your Pro API key. Save, refresh the tool list, and pick the Karma.Domains tool you need.

• Transport: HTTP Streamable
• URL: https://mcp.karma.domains/mcp
• Auth: Bearer Auth — paste YOUR_API_KEY

Manus

Settings → Connectors — Custom MCP

1. Open Settings → Connectors and click Add connectors.
2. Open the Custom MCP tab, click Add custom MCP server, and choose Direct configuration.
3. Set Transport type to HTTP, paste the Server URL, add a custom header Authorization with value Bearer YOUR_API_KEY, then try it in a new chat.

• Transport: HTTP
• URL: https://mcp.karma.domains/mcp
• Header: Authorization
• Auth: Bearer YOUR_API_KEY

OpenClaw

~/.openclaw/openclaw.json or Settings → MCP

1. Open ~/.openclaw/openclaw.json, or in the Control UI go to Settings → MCP → Add server.
2. Choose Streamable HTTP, paste the URL, and add the Authorization header.
3. Save and restart OpenClaw so the Karma.Domains tools load.

{
  "mcp": {
    "servers": {
      "karma-domains": {
        "url": "https://mcp.karma.domains/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Hermes

~/.hermes/config.yaml

1. Open ~/.hermes/config.yaml and add a karma-domains entry under mcp_servers.
2. Set the URL and Authorization Bearer header with your key.
3. Restart Hermes or run /reload-mcp, then confirm tools appear.

mcp_servers:
  karma-domains:
    url: "https://mcp.karma.domains/mcp"
    headers:
      Authorization: "Bearer YOUR_API_KEY"

Cursor

Settings → Tools & MCP, or ~/.cursor/mcp.json

1. Open Cursor and go to Settings → Cursor Settings → Tools & MCP.
2. Click Add Custom MCP (or edit mcp.json) and paste the configuration below.
3. Replace YOUR_API_KEY with your key, save, and reopen the chat.

{
  "mcpServers": {
    "karma-domains": {
      "url": "https://mcp.karma.domains/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Terminal — Claude Code CLI

1. Run the command below with your key.
2. In Claude Code, run /mcp and confirm Karma.Domains is listed.
3. Restart the session if the tools do not appear.

claude mcp add --header "Authorization: Bearer YOUR_API_KEY" --transport http karma-domains https://mcp.karma.domains/mcp

VS Code

.vscode/mcp.json in your workspace

1. Create a .vscode/mcp.json file in the workspace.
2. Paste the configuration below and replace YOUR_API_KEY.
3. Save and reload the window so the connectors pick up the change.

{
  "servers": {
    "karma-domains": {
      "url": "https://mcp.karma.domains/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex

~/.codex/config.toml or Codex CLI

1. Export your Pro key as KARMA_API_KEY (Codex reads the token from an env var, not from the file).
2. Run the CLI command below, or add the TOML block to ~/.codex/config.toml.
3. Verify with codex mcp list.

codex mcp add karma-domains --url https://mcp.karma.domains/mcp --bearer-token-env-var KARMA_API_KEY

Or add this to ~/.codex/config.toml:

[mcp_servers.karma-domains]
url = "https://mcp.karma.domains/mcp"
bearer_token_env_var = "KARMA_API_KEY"

Windsurf

Windsurf MCP settings, same JSON shape as Cursor

1. Open Windsurf MCP / connected services settings.
2. Add a custom connector with the JSON below.
3. Replace YOUR_API_KEY, save, and restart Windsurf.

{
  "mcpServers": {
    "karma-domains": {
      "url": "https://mcp.karma.domains/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cline

Cline MCP Servers panel, or ~/.cline/mcp.json

1. In the Cline panel open MCP settings → Configure, or edit ~/.cline/mcp.json.
2. Add a Streamable HTTP server (set type to streamableHttp — omitting it falls back to legacy SSE).
3. Paste your key in headers, save, and reopen the MCP panel to confirm it is connected.

{
  "mcpServers": {
    "karma-domains": {
      "type": "streamableHttp",
      "url": "https://mcp.karma.domains/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Continue

Continue config.yaml or .continue/mcpServers/

1. Open your Continue config.yaml (or add a file under .continue/mcpServers/).
2. Add a streamable-http endpoint with the URL and apiKey below.
3. Reload Continue so the Karma.Domains tools show up in chat.

mcpServers:
  - name: Karma.Domains
    type: streamable-http
    url: https://mcp.karma.domains/mcp
    apiKey: YOUR_API_KEY

Gemini CLI

Terminal — Gemini CLI

1. Install the Gemini CLI if you do not have it yet.
2. Run the command below with your key.
3. Verify with gemini mcp list — Karma.Domains should appear.

gemini mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" karma-domains https://mcp.karma.domains/mcp

Other

Any MCP client with Streamable HTTP and custom headers

1. Point the client at the MCP URL below.
2. Send Authorization: Bearer YOUR_API_KEY on every request.
3. If the client only supports local stdio servers, use the Claude Desktop mcp-remote wrapper.

Claude.ai, ChatGPT, and other OAuth MCP clients open a browser sign-in. Cursor and similar tools still use a Pro API key in the Authorization header.

{
  "mcpServers": {
    "karma-domains": {
      "url": "https://mcp.karma.domains/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart the client after saving the config.

How it works

1. Connect once — create a key in Profile → Settings and paste the config for your client.
2. Describe the task in words — niche, SEO metrics, auctions or expired. Same idea as the AI lookup in the app.
3. Open reports on the site — you get up to ten candidates from every source, a match count, and links to full reports and the filtered table.

Tools

Reports

• search_reports — Primary structured query — same fields as the app
• get_domain — Full report for an exact domain name
• instructions — Field glossary and filter catalogs

Account

• get_user_profile — Balance, plan, and email
• list_favorites — Saved domains across all bases
• add_favorite — Pin a domain with this tool
• remove_favorite — Delete a saved domain

Report workflow

• list_saved_filters — Saved search filters by name
• save_saved_filter — Create or replace a saved filter
• delete_saved_filter — Remove a saved filter
• list_annotation_tags — Your annotation tag vocabulary
• get_report_annotation — Note and tags on one report
• set_report_annotation — Save note and tags (Pro)
• delete_report_annotation — Clear annotation (Pro)
• create_share_link — Guest share URL (Pro)
• enrich_report_seo — Start SEO enrich job
• get_enrich_report_seo_job — Poll enrich job status

Live checks

1 credit per domain unless noted

• check_domain_expiry — Registration availability — 1 credit
• check_expired_report — Has this expired listing dropped? — free
• get_domain_karma_metric — Wayback Karma Metric — 1 credit
• domain_authority_checker — Live DA / DR / AS — 1 credit
• domain_age_checker — Wayback archive age — 1 credit
• domain_expiry_checker — Registration expiry dates — 1 credit
• backlink_checker — Moz backlinks — 1 credit
• anchor_text_checker — Moz anchors — 1 credit
• website_page_counter — Sitemap page count — 1 credit
• website_traffic_checker — SimilarWeb / Semrush traffic — 1 credit
• dns_lookup — DNS records — 1 credit
• whois_lookup — Structured WHOIS — 1 credit
• spam_score_checker — Moz Spam Score + DA / BL / RD — 1 credit

interpret_query is deprecated and not recommended. Prefer search_reports.

See MCP in action

A real search in chat — clean expired domains with at least 3 years of history for a French plumbing website.

Example prompts

1. Find expired .com names for a specialty coffee newsletter. Moz DA at least 25, KarmaScore above 60, English Wayback, no digits, under 14 characters.
2. GoDaddy auctions ending in 48 hours — restaurant or pizza niche, max $400, Majestic TF at least 15, skip hyphenated names.
3. Short brandable drops in .io and .co for an AI infra startup. No numbers, Karma Metric at least 70, length 8 or less.
4. Expired .com for a Texas auto shop with US SimilarWeb traffic and KarmaScore at least 50. If empty, lower the DA floor and include .net.
5. Open the full report for brewjournal.com and tell me Wayback spam risk versus the metrics.
6. Show my favorites, then add the strongest DA result from the last shortlist.
7. Check if mybrand.com can be registered right now. One credit is fine.
8. Karma Metric for the top three in the last shortlist. Drop anything under 40, then open reports for the rest.
9. How many credits do I have left, and am I on Pro?
10. Next page of the same expired SaaS query, sorted by KarmaScore.
11. Save this expired coffee filter as coffee-expired so I can rerun it tomorrow.
12. Tag brewjournal.com as vip and add a note: strong Wayback, check auction end.
13. Create a guest share link for the brewjournal.com report — I need to send it to a client.
14. Enrich SEO on the top result from the last shortlist and tell me when the job finishes.

FAQ

Is this the same as the Karma.Domains website?

Yes. Same databases and reports — auctions, expired, backorder, and buy-now. You work in AI chat instead of the browser. Full Wayback timelines stay on the site report.

Do I need the Pro plan?

Yes. The MCP server uses the same key as the Public API. Without Pro the key is not issued.

Will it work in ChatGPT, Cursor, or Claude?

Yes. ChatGPT and Claude.ai can use OAuth (browser sign-in on karma.domains) or a Bearer API key. Cursor and most IDE clients use a Pro API key in the Authorization header. Pick your client in Get started above. Keys live in Profile → Settings.

Why did the assistant find nothing?

The request is usually too vague or too strict. Add a niche, one or two metrics, and database type (auctions or expired). Ask for the next page or looser conditions.

Why won’t it connect?

Check the Pro plan. For OAuth, finish browser sign-in and approve access. For API key clients, copy the key fully and use https://mcp.karma.domains/mcp. Restart or reconnect after config changes.

Is it safe to store the key in the app?

The key stays on your machine in client settings and is sent over HTTPS. Do not share it. If it leaked, reset it in your profile.

What if I send many requests in a row?

Chat shares a 60 requests/minute limit with REST. If the assistant runs many steps at once, wait a minute and retry or simplify the task.

Why do I see “Authorization required” or blocked?

The key is missing, truncated, or you are not on Pro. Copy the key again from Profile → Settings and restart the client.

Why “Too many requests”?

You hit the shared 60 requests/minute cap. Wait a minute. Do not run dozens of queries in one turn.

Why “Could not understand the request”?

Rephrase with a niche, one or two metrics, and whether you want auctions or expired names. Include backlinks or SEO metrics if those matter.

Why “Domain not found in database”?

That exact domain is not in Karma.Domains. Try another query, a different extension, or another result from the list.

Why is expired re-check unavailable?

check_expired_report can run at most once every 3 hours on the same listing. Wait and retry, or open the report on the site.

Do annotations and share links need Pro?

Yes. set_report_annotation, delete_report_annotation, and create_share_link require the Pro plan. Listing tags with list_annotation_tags and reading annotations are included in your plan quota. Agent (x402) accounts pay 1 credit per write.

How does SEO enrich work in chat?

Ask the assistant to call enrich_report_seo with a report_id from search results, then poll get_enrich_report_seo_job until the job completes. Pro or Unlimited required. Successful enrich costs 3 credits (Pro) or 22 (Unlimited) — same as the website.

Where do I get report_id for workflow tools?

Every item in search_reports and get_domain includes report_id. Pass it to saved filters, annotations, share, and enrich tools — the same id you see in report URLs on the site.

Can AI agents pay with x402?

Yes. The MCP server accepts x402 paid requests — USDC agent credits, no browser account. Discovery manifest: /.well-known/x402.

Links

• Profile → Settings — API key
• Pro plan
• Public API
• x402 — paid requests for AI agents
• AI search help