# domain-check-skills-mcp

[![npm version](https://img.shields.io/npm/v/domain-check-skills-mcp?color=145DFB&label=npm&style=flat-square)](https://www.npmjs.com/package/domain-check-skills-mcp)
[![downloads](https://img.shields.io/npm/dm/domain-check-skills-mcp?color=145DFB&style=flat-square)](https://www.npmjs.com/package/domain-check-skills-mcp)
[![license](https://img.shields.io/npm/l/domain-check-skills-mcp?style=flat-square)](./LICENSE)

## ⚡ The fastest domain availability MCP server — or the second

The fastest domain availability MCP — or the second. A first-time check lands in **about half a second** (under 0.9 s at p95, measured from the US and the EU, September 2026); a repeat within 60 s is **~0.1 s** from the edge cache. Hard-capped so it never hangs. The pipeline (debounce → registry RDAP + DNS → third signal → edge cache) is published openly. Found something faster? [Dispute it](https://digmyname.com/speed).

MCP server to check domain availability from any LLM — Claude, Cursor, Windsurf, Continue, Zed. 6 registrars, 50+ TLDs. Powered by [DigMyName](https://digmyname.com).

| | |
| --- | --- |
| Typical latency | **about half a second** first-time check (p50 0.4–0.5 s, under 0.9 s at p95) · **~0.1 s** cache-warm — everyday numbers measured from the US and the EU in September 2026, not a lab result; the on-screen timer is the live proof |
| Method | Published at [digmyname.com/speed](https://digmyname.com/speed) |
| Coverage | 6 registrars · 50+ TLDs |
| Cost | Free — no API key, no account |

![domain-check-skills-mcp in action](https://digmyname.com/mcp-demo.svg)

## Install

Claude Code — one line:

```bash
claude mcp add domain-check -- npx -y domain-check-skills-mcp
```

Claude Desktop / Cursor / Windsurf — add to your MCP config:

```json
{
  "mcpServers": {
    "domain-check": {
      "command": "npx",
      "args": ["-y", "domain-check-skills-mcp"]
    }
  }
}
```

Continue (`~/.continue/config.json`):

```json
{
  "experimental": {
    "modelContextProtocolServers": [
      { "transport": { "type": "stdio", "command": "npx", "args": ["-y", "domain-check-skills-mcp"] } }
    ]
  }
}
```

Zed (`settings.json`):

```json
{
  "context_servers": {
    "domain-check": {
      "command": { "path": "npx", "args": ["-y", "domain-check-skills-mcp"] }
    }
  }
}
```

VS Code (`.vscode/mcp.json`):

```json
{
  "servers": {
    "domain-check": { "type": "stdio", "command": "npx", "args": ["-y", "domain-check-skills-mcp"] }
  }
}
```

No API key, no account, no config — it works right after install.

## Tools

| Tool | Description |
| --- | --- |
| `check_domain` | Availability, premium / likely-premium flags, cheapest registrar, direct buy link and registration year (when taken) for one domain. |
| `search_domains` | One name across many TLDs at once (defaults to a curated set of 11). Includes availability, price, buy link and registration year for taken results. |
| `compare_registrars` | Registration, renewal and 3-year totals per registrar for a TLD. |
| `get_domain_age` | Registration year and expiration date for a taken domain via RDAP. |

## Example prompts

- "Is `acme.io` available and where is it cheapest?"
- "Check `nebula` across com, io, ai, dev and app."
- "Compare registrar prices for `.ai`."
- "When was `stripe.com` registered?"

## How it works

Availability is resolved through an **authoritative-first** chain — RDAP (IANA bootstrap), authoritative DNS-over-HTTPS (Cloudflare, Google and AdGuard, hedged), Fastly Domain Research and registrar APIs. Anything unresolved is returned as `UNKNOWN` rather than falsely reported as taken. Premium candidates are flagged separately so agents never quote a standard retail price for a registry-premium name.

Pricing comes from DigMyName's registrar price cache across 6 registrars and 50+ TLDs.

Domain age is read from registry RDAP endpoints.

Rate limit: 60 requests / minute / IP. Repeat lookups are served from the Cloudflare edge cache in about 0.1 s.

## Configuration

| Env var | Default | Purpose |
| --- | --- | --- |
| `DIGMYNAME_API_BASE` | `https://api.digmyname.com/functions/v1/public-api` | Override the API base. Set this to the direct Supabase URL to bypass the edge cache. |

## Releasing (maintainers)

Releases are published from a maintainer's machine:

```bash
cd mcp
# bump the version in package.json, server.json (two places) and the VERSION constant in src/index.ts; add a CHANGELOG entry
npm run build
npm publish --provenance=false   # npm asks you to confirm in the browser (web-based 2FA)
```

The `Publish MCP to npm` workflow (tag `mcp-v*`) would publish with provenance from CI, but it needs an `NPM_TOKEN` repo secret that is not configured; releases so far have been published without provenance.

## Requirements

Node.js 18+

## Changelog

See [CHANGELOG.md](./CHANGELOG.md).

## License

MIT