TLDers Domain Prices — MCP server
Live domain prices from 145+ registrars and 1,100+ TLDs, as a remote Model Context Protocol server. Ask your AI assistant where a domain is cheapest to register, renew or transfer, compare extensions, find promo codes and check availability — with real, daily-updated prices from TLDers.
Use it two ways: connect to the hosted server at https://www.tlders.com/api/mcp, or run this repository's small local (stdio) server, which forwards each tool call to the hosted one with your key.
Connect
- Get a free API key at https://www.tlders.com/developers (no card needed).
- Add a remote MCP server (Streamable HTTP):
| Client | Setting |
|---|---|
| Clients that support headers (Claude Code, Cursor, VS Code, MCP Inspector) | URL https://www.tlders.com/api/mcp, header Authorization: Bearer tld_live_... |
| claude.ai custom connectors and other clients without header support | URL https://www.tlders.com/api/mcp?key=tld_live_... |
Claude Code:
claude mcp add --transport http tlders https://www.tlders.com/api/mcp \
--header "Authorization: Bearer tld_live_..."
Treat a URL with ?key= like a password. If it leaks, revoke the key from your TLDers account and create a new one.
Local (stdio) server
For Claude Desktop's config file and other clients that run local servers. Needs Node.js 18+.
{
"mcpServers": {
"tlders": {
"command": "npx",
"args": ["-y", "@tlders/mcp"],
"env": { "TLDERS_API_KEY": "tld_live_..." }
}
}
}
To run the server from source instead of the published package (useful while changing it), clone this repo, run npm install, then use "command": "node", "args": ["/path/to/tlders-mcp/index.js"]. It reads the same TLDERS_API_KEY variable, and TLDERS_MCP_URL overrides the hosted endpoint.
Plugin install
This repo is also an Agent Plugins package (plugin.json + mcp.json) that connects to the hosted server. Once installed, add your key by passing it as the api_key argument or switching the server URL to https://www.tlders.com/api/mcp?key=tld_live_....
Tools
| Tool | What it does |
|---|---|
find_cheapest_tlds | Cheapest registrar per extension for first-year registration, renewal, transfer and 3-year total |
get_tld_prices | Every registrar's register / renew / transfer price for one extension, cheapest first |
compare_tlds | Compare registrar prices across up to 20 extensions |
get_tld_price_history | Per-registrar registration and renewal price history |
list_promo_codes | Active registrar promo codes, biggest discount first |
check_domain_availability | Live availability for a full domain name (RDAP, WHOIS fallback) |
list_registrars | Every tracked registrar with WHOIS-privacy info |
Prices are USD per year. First-year prices are often promotions, so the renewal price is always included.
All tools are read-only. Each one is annotated readOnlyHint: true, destructiveHint: false and idempotentHint: true. Nothing is bought, registered or changed, so clients can run them without asking for confirmation.
Example prompts
- "Where is a .com cheapest to register and to renew?"
- "Compare .io, .ai and .dev prices over three years."
- "Is my-startup.dev available, and which registrar should I buy it from?"
- "Are there any promo codes for .xyz right now?"
Plans
| Plan | Limit |
|---|---|
| Free | 100 requests a month, one key |
| Monthly ($5) / Yearly | 1,000 requests a day per key, up to 5 keys, plus bulk prices |
Full API docs and the OpenAPI spec: https://www.tlders.com/developers
Development
npm install
npm test # node --test: every tool, its annotations and error handling, no network needed