# Expired Domains MCP

Hosted **MCP server** for expired, dropping, auction, backorder, and buy-now domains — powered by [Karma.Domains](https://karma.domains). Search 400k+ daily listings with SEO metrics, Wayback history, and live domain checkers from Cursor, Claude, ChatGPT, and other MCP clients.

This repository is the **catalog listing** (README + `server.json`). The server itself runs at `https://mcp.karma.domains/mcp`.

## Quick start

### Cursor / MCP config (API key)

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

Generate a key in **Profile → Settings** on a [Pro plan](https://karma.domains/app/pricing/).

### Claude / ChatGPT (OAuth)

Connect the remote server URL `https://mcp.karma.domains/mcp`. Unauthenticated calls return **401** with OAuth Protected Resource Metadata; sign in at karma.domains. No API key paste required for those connectors.

### Agent credits (x402)

Calls without auth may include `PAYMENT-REQUIRED`. Pay USDC (exact scheme), retry the **same URL** with `PAYMENT-SIGNATURE` and optional `X-Karma-Plan-Id`. Details: [x402 skill](https://karma.domains/.well-known/agent-skills/x402-commerce/SKILL.md).

## Tools

| Tool | Description |
|------|-------------|
| `instructions` | Agent guide, `filter_catalog`, response schema, glossary |
| `search_reports` | Primary structured filter search (same fields as the app / Public API) |
| `interpret_query` | Deprecated — last-resort NL→filter only |
| `get_domain` | Exact domain → report (auctions → expired → backorder → buynow) |
| `get_user_profile` | Profile and spendable `balance` |
| `list_favorites` / `add_favorite` / `remove_favorite` | Favorites |
| `list_saved_filters` / `save_saved_filter` / `delete_saved_filter` | Saved searches |
| `list_annotation_tags` / `get_report_annotation` / `set_report_annotation` / `delete_report_annotation` | Notes and tags |
| `create_share_link` | Guest share URL |
| `enrich_report_seo` / `get_enrich_report_seo_job` | Paid SEO enrich job + poll |
| `check_domain_expiry` | Live availability (WHOIS/DNS) |
| `check_expired_report` | Drop check for an expired-base report |
| `get_domain_karma_metric` | Live Karma Metric from Web Archive |
| `domain_authority_checker` | Live DA/DR/AS |
| `domain_age_checker` | Wayback archive age |
| `domain_expiry_checker` | WHOIS expiry dates |
| `backlink_checker` | Moz backlinks |
| `anchor_text_checker` | Moz anchor texts |
| `website_page_counter` | Sitemap page count |
| `website_traffic_checker` | SimilarWeb / Semrush traffic |
| `dns_lookup` | DNS records |
| `whois_lookup` | Structured WHOIS/RDAP |
| `spam_score_checker` | Moz Spam Score |

Prefer `search_reports` plus `instructions.filter_catalog` for categories and auction sources. Do not use `interpret_query` for pagination.

## Limits

- **60 requests/min** per user (shared with the Public API)
- **50,000 list rows/day** (UTC)
- **200 non-cache live-tool calls/day** (UTC; cache hits free)
- Pagination: `page × page_size ≤ 5000`

## Links

- Human docs: [Expired Domains MCP](https://karma.domains/en/expired-domains-mcp/)
- REST API: [Expired Domains API](https://karma.domains/en/expired-domains-api/)
- Registry metadata: [server.json](https://karma.domains/.well-known/mcp/server.json)
- Health: `GET https://mcp.karma.domains/health`

## Topics

`expired-domains` `mcp` `seo` `drop-catching` `domain-auctions` `backlinks`

## License

MIT