# Domain MCP server

Add Unique Domains to an AI assistant as tools, through MCP (the Model Context Protocol): a name’s stored status and registry record, an ending’s facts and launch dates, registrar prices and their changes, the sales market as totals, the day’s auctions, trends and the industry agenda. Every tool reads the same data as the API.

- Hosted at https://mcp.unique.domains/mcp: no key, no sign-in and nothing to install, with the API’s free tools, apart from the three that answer one word or one ending a caller a day (a word’s sales, a word’s market, an ending’s registrar prices) and two that add nothing a conversation needs (a second way to look a name up, how current each part of the data is), which run on your machine.
- On your machine, a member key in UD_API_KEY adds the paid tools of its plan, Founder or Investor.
- The free tools read stored data. None registers, buys or changes a name.

## Add it to your assistant

### Claude

In Claude, on the web or the desktop app, open Customize, then Connectors, choose "+ Add", then "Add custom connector", and paste this address. No sign-in is needed. On a Team or Enterprise plan, an Owner adds it first.

```text
https://mcp.unique.domains/mcp
```

### Claude Code

Run this once in a terminal.

```bash
claude mcp add --transport http uniquedomains https://mcp.unique.domains/mcp
```

### Cursor

Put this in .cursor/mcp.json, in your project or your home folder.

```json
{
  "mcpServers": { "uniquedomains": { "url": "https://mcp.unique.domains/mcp" } }
}
```

### VS Code

Run this once in a terminal.

```bash
code --add-mcp '{"name":"uniquedomains","type":"http","url":"https://mcp.unique.domains/mcp"}'
```

### ChatGPT

Open chatgpt.com/plugins, choose the plus button, then "Add custom MCP server", paste this address with no authentication and choose "Create as a plugin". Install it, then type @ in a new chat and pick it.

```text
https://mcp.unique.domains/mcp
```

### On your machine

The same server runs on your machine with Node.js 20 or later, in any client that starts a local server, such as Claude Desktop's claude_desktop_config.json. Its calls come from your own address. Put your member key in UD_API_KEY for the paid tools of your plan, or leave env out for the free tools.

```json
{
  "mcpServers": {
    "uniquedomains": {
      "command": "npx", "args": ["-y", "@uniquedomains/mcp-server"],
      "env": { "UD_API_KEY": "ud_live_your_key" }
    }
  }
}
```

## Try asking

- What is the registry record of get.plumbing?
- What are the newest registrar price changes?
- What is on the domain industry agenda this month?

## The package

- `npx -y @uniquedomains/mcp-server`, @uniquedomains/mcp-server on npm
- In the official MCP Registry as domains.unique/mcp-server.
- Source on GitHub: https://github.com/UniqueDomains/mcp-server

## Questions

### Does the MCP server need a key?

No. The hosted server answers with no key and no sign-in, with the API’s free tools, apart from the three that answer one word or one ending a caller a day (a word’s sales, a word’s market, an ending’s registrar prices) and two that add nothing a conversation needs (a second way to look a name up, how current each part of the data is), which run on your machine. On your machine, a member key in UD_API_KEY adds the paid tools of its plan, Founder or Investor.

### Can the assistant change anything?

The free tools only read stored data: none registers, buys or changes a name. With a member key, a live check reads a name from its registry now, and with an Investor key an appraisal values a name and a word intake asks for a word to be added to the catalog. Each can count one unit of the plan, only when the read or the model runs.

### Why does a tool say the day’s calls are spent?

The hosted server calls the API as one caller for every assistant that uses it, under one daily allowance. When it is spent, the tool says so and when it resets, at midnight UTC. The server on your machine calls the API from your own address, within 60 calls an hour and 100 a day from one address.

Full reference: https://unique.domains/api