tld-list-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RDAP_ENABLED | No | Enable RDAP availability inference. | true |
| TLD_LIST_MCP_DEBUG | No | Write sanitized diagnostics to stderr. | false |
| TLD_LIST_PUBLIC_KEY | Yes | TLD-List public API key. | |
| RDAP_MAX_CONCURRENCY | No | Maximum concurrent checks in a bulk request. | 5 |
| TLD_LIST_MAX_RETRIES | No | Bounded retries for transient timeouts/network/5xx errors. Authentication and rate-limit errors are not retried. | 2 |
| TLD_LIST_PRIVATE_KEY | Yes | TLD-List private API key. | |
| TLD_LIST_API_BASE_URL | No | API base URL; primarily useful for controlled tests. | https://api.tld-list.com/v1 |
| TLD_LIST_CACHE_ENABLED | No | Enable the in-memory cache. | true |
| RDAP_REQUEST_TIMEOUT_MS | No | RDAP request timeout. | 10000 |
| TLD_LIST_TLDS_CACHE_TTL_MS | No | TLD-name cache TTL. | 86400000 |
| RDAP_BOOTSTRAP_CACHE_TTL_MS | No | IANA RDAP bootstrap cache TTL. | 86400000 |
| TLD_LIST_REQUEST_TIMEOUT_MS | No | Per-request timeout. | 15000 |
| TLD_LIST_PRICING_CACHE_TTL_MS | No | Pricing/metadata cache TTL. | 900000 |
| TLD_LIST_REGISTRARS_CACHE_TTL_MS | No | Registrar-ID cache TTL. | 86400000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_tld_variantsB | Search one name or up to 20 names across TLDs. Batches TLD-List pricing, optionally filters by price/registrar and availability, and returns separate cheapest registration, renewal, transfer, and same-registrar 3-year costs. Popularity sorting is intentionally unavailable because API v1 does not document ranking data. |
| check_domainA | Check one fully qualified domain through the separate RDAP availability provider. A found record means registered; a 404 suggests availability but is explicitly non-authoritative and not a purchase guarantee. |
| compare_registrarsB | Compare documented registration, renewal, and/or transfer pricing for one TLD at selected TLD-List registrar IDs, including missing prices, promotions, terms, and notes. |
| cheapest_registrarB | Find the cheapest registrar or tied registrars for one TLD and one price type. Uses TLD-List v1 extension/getCheapestRegistrar and supports documented registrar include/exclude lists. |
| compare_tldsB | Batch-compare up to 100 extensions by cheapest registration, renewal, transfer, and same-registrar multi-year ownership cost, with documented TLD metadata. |
| calculate_domain_costA | Calculate 1-10 year ownership cost for one registrar/TLD pair as year-1 registration plus subsequent current renewal prices. Never combines currencies and returns assumptions. |
| list_registrarsA | List active TLD-List registrar IDs with substring filtering and pagination. Use these exact IDs in other tools. |
| list_tldsB | List extensions supported by TLD-List with substring search, pagination, Unicode/punycode selection, and optional documented metadata for the returned page. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools target clearly distinct operations (list TLDs, list registrars, check availability, calculate cost). However, search_tld_variants and compare_tlds both batch-compare pricing across TLDs, and compare_registrars overlaps with cheapest_registrar for registrar price comparison. Descriptions help clarify intent, but some boundaries remain fuzzy.
All names use consistent snake_case, which is readable and predictable. The only minor deviation is cheapest_registrar, which uses an adjective rather than a verb, unlike the other action-oriented names.
Eight tools is well-scoped for a TLD pricing and availability server. Each tool covers a distinct aspect of lookup, comparison, or calculation without unnecessary bloat.
The surface covers core needs: listing TLDs and registrars, checking availability, comparing prices across TLDs/registrars, finding cheapest options, and calculating multi-year costs. Minor gaps exist, such as no bulk availability check beyond search_tld_variants and no dedicated registrar-detail tool.