# Domain MCP

> Free domain search API and MCP server: whether a domain is free, what it costs to register and renew, who holds a taken one, and name ideas that are free. No key and no sign-in. REST at https://api.domainmcp.net/v1/, MCP at https://domainmcp.net/mcp.

Everything is paced per address: 60 domains a minute and 2,000 a day. Free domains come with a buy_url to register them.

## Docs

- [Full manual](https://domainmcp.net/manual.md): every page below in one Markdown file
- [Agent skill](https://domainmcp.net/skill.md): when and how an agent should use it
- [OpenAPI](https://domainmcp.net/openapi.json): the REST API described

## Guides

- [Overview](https://domainmcp.net/documentation): Documentation for the free Domain MCP API and MCP server: endpoints, tools, limits, errors and setup for every assistant.
- [Quick start](https://domainmcp.net/documentation/quick-start): Make your first domain availability call in under a minute: no key, no sign-up, one line of curl.
- [Reading a result](https://domainmcp.net/documentation/reading-a-result): What available, taken and unknown mean in a Domain MCP result, how answers are confirmed, and the price and buy link fields.
- [Limits](https://domainmcp.net/documentation/limits): Domain MCP API rate limits: 60 domains a minute and 2,000 a day per address, the headers that report them, and MCP pacing.
- [Errors](https://domainmcp.net/documentation/errors): Every Domain MCP API error code, what causes it and what to do, plus inputs skipped inside a successful answer.
- [Prices and endings](https://domainmcp.net/documentation/prices): How Domain MCP domain prices work: first year, renewal, minimum years, offers, premium names and which endings are covered.
- [Buy links](https://domainmcp.net/documentation/buy-links): What the buy_url on a free domain is, where it goes and how it keeps Domain MCP free.
- [Changelog](https://domainmcp.net/documentation/changelog): Changes to the Domain MCP API, MCP server and documentation.

## Endpoints

- [API overview](https://domainmcp.net/documentation/api): The Domain MCP REST API: base address, answer shape, parameters, CORS and every endpoint, free with no key.
- [GET /v1/check](https://domainmcp.net/documentation/check): Give up to 50 full domains and find out which are free to register, with today's domain prices and a buy link for each free one.
- [GET /v1/search](https://domainmcp.net/documentation/search): Give one name and get back every ending you ask for, free ones first and cheapest first, each with today's domain prices and a link to register it.
- [GET /v1/suggest](https://domainmcp.net/documentation/suggest): Describe a business or project in a few words and get back name ideas, each one checked and free to register, with a line on why it fits.
- [GET /v1/details](https://domainmcp.net/documentation/details): Everything known about one domain: free or taken, and for a taken one who holds it, when it was registered, when it expires and its nameservers.
- [GET /v1/prices](https://domainmcp.net/documentation/prices-endpoint): The public price of registering a domain on any ending: the first year, the renewal, the fewest years sold, and whether the first year is on offer.
- [GET /v1/usage](https://domainmcp.net/documentation/usage): How much of your allowance is left this minute and today, without spending any of it.

## Assistants

- [MCP server](https://domainmcp.net/documentation/mcp): The Domain MCP server address, transport, tools and pacing, with a walkthrough for every assistant.
- [MCP tools](https://domainmcp.net/documentation/mcp-tools): The five Domain MCP tools: check_domains, search_name, suggest_names, domain_details and ending_prices.
- [Agent skill](https://domainmcp.net/documentation/agent-skill): The Domain MCP agent skill: a SKILL.md file agents can read to use the domain search API.
- [Claude](https://domainmcp.net/documentation/claude): Add the free Domain MCP server to Claude in a minute: a custom connector, no sign-in.
- [ChatGPT](https://domainmcp.net/documentation/chatgpt): Add the free Domain MCP server to ChatGPT in a minute: a custom MCP server, no authentication.
- [Gemini](https://domainmcp.net/documentation/gemini): Add the free Domain MCP server to Gemini in a minute: a custom app or Gemini CLI.
- [Claude Code](https://domainmcp.net/documentation/claude-code): Add the free Domain MCP server to Claude Code in a minute: one terminal command.
- [Cursor](https://domainmcp.net/documentation/cursor): Add the free Domain MCP server to Cursor in a minute: three lines in mcp.json.
- [VS Code](https://domainmcp.net/documentation/vscode): Add the free Domain MCP server to VS Code in a minute: MCP: Add Server, or .vscode/mcp.json.
- [Windsurf](https://domainmcp.net/documentation/windsurf): Add the free Domain MCP server to Windsurf in a minute: Cascade's MCP config file.