Cuotas

Términos

• La cuota es lo que permite tu plan: cada herramienta que consume cuota tiene un límite por hora y otro por día.
• Una categoría es un tipo de consulta, como whois o query. Cada llamada a una herramienta se imputa a una categoría, y cada categoría tiene sus propios límites. El sitio web consume las mismas categorías.

Cómo se contabilizan las llamadas

Las llamadas MCP consumen la cuota de tu plan de NameBeta, en las mismas categorías que el sitio web. Una consulta WHOIS en namebeta.com y una llamada a lookup_whois consumen la misma cuota, y ambas aparecen en Plan y uso de tu panel de cuenta.

• Solo cuenta tools/call. initialize, tools/list, ping y las demás solicitudes del protocolo son gratuitas.
• Cada llamada cuenta una vez, contenga lo que contenga. Una llamada a check_availability con 20 dominios cuenta como una.
• suggest_domains es gratuita, igual que las sugerencias en el sitio web.
• La llamada cuenta en cuanto se acepta, antes de que se ejecute la herramienta. Una llamada que termina en un error de herramienta (un dominio no válido, un servidor WHOIS que no responde) también cuenta. Una llamada a una herramienta que no existe, no.
• Una llamada rechazada no cuenta. Si has superado un límite, la respuesta 429 no te cuesta nada.
• Los límites dependen de tu plan. MCP siempre se usa con la sesión iniciada, así que nunca se aplican los límites anónimos del sitio web.

Límites

Una llamada tiene que caber tanto en el límite por hora como en el límite por día de su categoría.

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
compare_prices	single	150 / 250	1,200 / 3,600	2,000 / 8,000	Ilimitado
suggest_domains	No contado
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Ilimitado
lookup_dns	dns	20 / 50	200 / 400	500 / 1,000	Ilimitado

check_availability consume una de dos categorías según su entrada; consulta su sección Cuota. Los planes y precios están en namebeta.com/es/pricing.

Cuándo se restablecen los límites

Las ventanas van en UTC

Las ventanas de cuota son fijas y están alineadas con UTC, sea cual sea tu zona horaria:

• Los límites por hora se restablecen al comienzo de cada hora UTC: 13:00, 14:00, 15:00 UTC, etc.
• Los límites por día se restablecen a las 00:00 UTC. Eso equivale a la 01:00 o las 02:00 en Madrid (según el horario de invierno o de verano), a las 18:00 del día anterior en Ciudad de México, a las 21:00 del día anterior en Buenos Aires, a las 08:00 en Pekín y a las 09:00 en Tokio.

Las ventanas no son móviles. Las llamadas hechas a las 13:59 UTC y a las 14:00 UTC caen en horas distintas, así que al comienzo de cada hora UTC vuelve a estar disponible la cuota por hora completa.

Por encima del límite: 429 y Retry-After

Una llamada que supera cualquiera de los dos límites se rechaza a nivel HTTP, antes de llegar a la herramienta:

HTTP/1.1 429 Too Many Requests
Retry-After: 1260
Content-Type: application/json

{
    "jsonrpc": "2.0",
    "error": {
        "code": -32000,
        "message": "MCP hourly quota exceeded.",
        "data": { "retryAfter": 1260 }
    },
    "id": 7
}

Parte	Valor
Estado	Siempre 429 Too Many Requests, tanto para el límite por hora como para el límite por día
Cabecera Retry-After	Segundos que faltan para que se restablezca la ventana superada: de 1 a 3600 para el límite por hora y de 1 a 86 400 para el límite por día
error.code	-32000
error.message	MCP hourly quota exceeded. o MCP daily quota exceeded.
error.data.retryAfter	Los mismos segundos que Retry-After
id	El id de tu solicitud

El límite por día se comprueba primero. Cuando ambos límites están agotados, la respuesta indica el diario, y Retry-After apunta a las 00:00 UTC: reintentar a la hora siguiente volvería a fallar.

Qué deben hacer los clientes

• Esperar al menos los segundos de Retry-After antes de volver a llamar a la misma herramienta. Si reintentas antes, recibirás otro 429.
• Las demás categorías no se ven afectadas. Cuando lookup_whois alcanza su límite, lookup_dns y compare_prices siguen funcionando.
• Decirle al usuario cuándo se restablece el límite, en lugar de reintentar en bucle. Con un límite diario, la espera puede durar casi un día.