`check_availability`

Comprueba si los dominios se pueden registrar. Es el buscador de NameBeta convertido en herramienta: un dominio completo como kettlory.com se comprueba por sí solo, y una etiqueta sin extensión como kettlory se expande al conjunto de TLD predeterminado y a los domain hacks que muestra la página de búsqueda.

Solo lectura · Mundo abierto

Pregúntale a tu asistente

Pega esto en una conversación con NameBeta conectado:

¿Qué TLD siguen libres para brewlab? De los que ya están registrados, ¿cuáles están en venta?

Tu asistente llama a check_availability con brewlab, y la respuesta debería combinar los tres estados; el ejemplo muestra lo que devolvió la herramienta el 29 de septiembre de 2026.

Entrada

Campo	Tipo	Requerido	Restricciones
`domains`	`string[]`	Sí	1–20 elementos; cada uno 1–253 caracteres

Salida

Devuelto como structuredContent, y repetido como JSON en un bloque de contenido text.

Campo	Tipo	Requerido	Restricciones
`results`	`object[]`	Sí
`results[].domain`	`string`	Sí
`results[].status`	`string`	Sí	Uno de `available`, `taken`, `unknown`, `forsale`, `reserved`, `tld`, `sld`, `publicsuffix`
`results[].url`	`string`	Sí	Formato `uri`

Comportamiento

Cada elemento de domains se procesa por separado, y los resultados se concatenan en el orden de entrada.
Un elemento con punto se comprueba como un único dominio y produce un resultado.
Un elemento sin punto es una etiqueta sin extensión. Produce un resultado por cada TLD predeterminado (.com, .net, .org, .io, .ai y otros), seguido de domain hacks como ke.tt. Una etiqueta suele producir entre 10 y 20 resultados.
Los caracteres que no pueden aparecer en un nombre de dominio (espacios, !, _ y cualquier otro signo de puntuación salvo puntos y guiones) se eliminan antes de analizar el elemento, y el resto se pasa a minúsculas. my startup! se comprueba como la etiqueta mystartup, sin error. El campo domain de cada resultado muestra lo que se comprobó realmente.
status procede de una comprobación en tiempo real de la delegación DNS, la misma señal que usa el buscador de namebeta.com. Hay una excepción: una consulta WHOIS de un dominio, ya sea mediante lookup_whois o con la herramienta WHOIS de namebeta.com y la haga quien la haga, guarda el estado de ese dominio durante 1 hora, y durante esa hora check_availability devuelve el estado guardado en lugar de volver a comprobarlo. Usa lookup_whois para confirmarlo antes de registrar.
url abre la página del dominio en namebeta.com, con los precios y el WHOIS.

Valores de estado

`status`	Significado
`available`	Se puede registrar ahora
`taken`	Ya está registrado
`forsale`	Está registrado, pero a la venta
`reserved`	Lo reserva el operador de registro y no está abierto al registro normal
`unknown`	La comprobación DNS no obtuvo una respuesta clara, normalmente por un tiempo de espera agotado en un servidor de nombres; vuelve a intentarlo
`tld`	La entrada es un dominio de nivel superior, como `com`
`sld`	La entrada es un sufijo de segundo nivel como `co.uk`, no un dominio registrable
`publicsuffix`	La entrada figura en la Public Suffix List y no se puede registrar como dominio

Ejemplo

Argumentos:

{ "domains": ["brewlab"] }

Resultado completo de una llamada realizada el 29 de septiembre de 2026:

{
    "results": [
        {
            "domain": "brewlab.com",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.com"
        },
        {
            "domain": "brewlab.net",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.net"
        },
        {
            "domain": "brewlab.org",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.org"
        },
        {
            "domain": "brewlab.info",
            "status": "available",
            "url": "https://namebeta.com/search/brewlab.info"
        },
        {
            "domain": "brewlab.io",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.io"
        },
        {
            "domain": "brewlab.co",
            "status": "forsale",
            "url": "https://namebeta.com/search/brewlab.co"
        },
        {
            "domain": "brewlab.xyz",
            "status": "forsale",
            "url": "https://namebeta.com/search/brewlab.xyz"
        },
        {
            "domain": "brewlab.ai",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.ai"
        },
        {
            "domain": "brewlab.online",
            "status": "available",
            "url": "https://namebeta.com/search/brewlab.online"
        },
        {
            "domain": "brewlab.dev",
            "status": "taken",
            "url": "https://namebeta.com/search/brewlab.dev"
        },
        {
            "domain": "brew.la",
            "status": "taken",
            "url": "https://namebeta.com/search/brew.la"
        },
        {
            "domain": "brw.lb",
            "status": "available",
            "url": "https://namebeta.com/search/brw.lb"
        },
        {
            "domain": "b.re",
            "status": "available",
            "url": "https://namebeta.com/search/b.re"
        },
        {
            "domain": "b.rw",
            "status": "taken",
            "url": "https://namebeta.com/search/b.rw"
        }
    ]
}

Los diez primeros resultados son los TLD predeterminados, en este orden; los cuatro últimos son domain hacks. Los estados cambian a medida que los dominios se registran y se liberan, así que la misma llamada hecha más adelante puede devolver una combinación distinta.

Cuota

La categoría de cuota que consume una llamada depende de su entrada: si algún elemento de domains es una etiqueta sin extensión, la llamada consume query, la misma categoría que una búsqueda en el sitio web; si todos los elementos son dominios completos, consume check.

Herramienta	Categoría	Gratis (hora / día)	Pro (hora / día)	Negocios (hora / día)	Empresarial (hora / día)
`check_availability` con cualquier etiqueta simple	`query`	90 / 450	360 / 1,800	600 / 3,000	Ilimitado
`check_availability` solo con nombres de dominio completos	`check`	45 / 135	120 / 360	300 / 900	Ilimitado

Para comprobar muchos nombres concretos con poco consumo, envíalos como dominios completos en una sola llamada de hasta 20.

Errores

Errores propios de esta herramienta. Errores cubre el resto, incluido cómo llega cada tipo a tu cliente.

Los elementos mal formados rara vez fallan: primero se eliminan los caracteres sobrantes, como se describe en Comportamiento.

Situación	Resultado
Un elemento queda vacío tras eliminar los caracteres no válidos, o es un nombre completo con un TLD que NameBeta no conoce	Error de herramienta `Invalid domain format`; la llamada no devuelve ningún resultado
Array vacío o con más de 20 elementos	Error de herramienta `MCP error -32602: Input validation error: …`

Véase también

suggest_domains: nombres que comprobar
compare_prices: precios de los dominios disponibles
lookup_whois: confirmar un estado antes de registrar
Herramientas: las cinco herramientas y cómo se combinan
Cuotas y Errores
Conectar un cliente, si tu asistente aún no muestra las herramientas de NameBeta

Pregúntale a tu asistente​

Entrada​

Salida​

Comportamiento​

Valores de estado​

Ejemplo​

Cuota​

Errores​

Véase también​