domainmcp
Use the API Add the MCP
SearchCheck a name across every endingDomain pricesFirst year and renewal, every endingMCP setupClaude, ChatGPT and Gemini in a minuteAPIOpen REST endpoints, no key neededDocumentationEvery endpoint, tool and limit
Use the APIAdd the MCP

Documentation / Guides / Errors

Domain API error codes

Errors

A refusal always comes back in the same shape, with a code to act on and a sentence you can show to a person.

The shape

Error
{
    "error": {
        "code": "bad_request",
        "message": "Give a name to search for, such as name=brightfield.",
        "docs": "https://domainmcp.net/documentation"
    }
}

Act on code; show message to a person if you like. The HTTP status matches.

Codes

bad_request400
Something needed is missing or not usable: no name, a list too long, a body that is not JSON. The message says which.
not_found404
No such endpoint. The list is at https://api.domainmcp.net/.
method_not_allowed405
The endpoint does not take that method. The Allow header lists the ones it does.
unknown_parameter422
A parameter the endpoint does not take, usually a typo. The message lists the ones it does.
rate_limited429
Over 60 domains this minute. Wait for Retry-After.
quota_exceeded429
Over 2,000 domains today. It resets at 00:00 UTC.
server_error500
Something went wrong on our side. It is logged and looked at; try again shortly.
not_ready503
A feature is being switched on. The message says what to use meanwhile.
suggest_failed503
Name ideas could not be drafted just now. Try again in a minute.

Skipped inputs

When some of a list can be checked and some cannot, the answer still succeeds. The ones that could not are left out of data and listed in meta.skipped:

meta.skipped
{
    "skipped": [
        {
            "input": "brightfield",
            "error": "no_ending"
        },
        {
            "input": "brightfield.notreal",
            "error": "unknown_ending"
        }
    ]
}
invalid_domainskipped
Not a domain: characters a domain cannot have, or a part too long.
no_endingskipped
A name with no ending, such as brightfield. Use /v1/search for a bare name.
unknown_endingskipped
An ending we cannot check or price.
invalid_nameskipped
A search name a domain cannot have.

From the MCP server

Tools answer refusals as a tool result marked as an error, with the same plain sentence, so the assistant can tell the person what happened.

PreviousLimits