Cotas

Termos

• Cota é o que o seu plano permite: cada ferramenta contabilizada tem um limite por hora e um diário.
• Uma categoria é um tipo de consulta, como whois ou query. Cada chamada de ferramenta é contabilizada em uma categoria, e cada categoria tem seus próprios limites. O site usa as mesmas categorias.

Como as chamadas são contabilizadas

As chamadas MCP consomem a cota do seu plano do NameBeta, nas mesmas categorias do site. Uma consulta WHOIS em namebeta.com e uma chamada a lookup_whois gastam a mesma cota, e ambas aparecem em Plan & Usage no seu painel da conta.

• Só tools/call é contabilizado. initialize, tools/list, ping e outras solicitações do protocolo são gratuitas.
• Cada chamada conta uma vez, independentemente do conteúdo. Uma chamada a check_availability com 20 domínios conta como uma.
• suggest_domains é gratuito, assim como as sugestões no site.
• A chamada é contabilizada quando é aceita, antes de a ferramenta ser executada. Uma chamada que termina em erro de ferramenta (um domínio inválido, um servidor WHOIS que não responde) ainda conta. Uma chamada a uma ferramenta desconhecida não conta.
• Uma chamada rejeitada não conta. Quando você está acima de um limite, a resposta 429 não consome nada.
• O seu plano define os limites. O MCP sempre funciona com um usuário autenticado, então os limites anônimos do site nunca se aplicam.

Limites

Uma chamada precisa caber tanto no limite por hora quanto no limite diário da sua categoria.

Ferramenta	Categoria	Gratuito (hora / dia)	Pro (hora / dia)	Business (hora / dia)	Enterprise (hora / dia)
check_availability com qualquer rótulo simples	query	90 / 450	360 / 1,800	600 / 3,000	Ilimitado
check_availability apenas com nomes de domínio 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	Não contado
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Ilimitado
lookup_dns	dns	20 / 50	200 / 400	500 / 1,000	Ilimitado

check_availability é contabilizado em uma de duas categorias, dependendo da entrada; consulte a seção Cota da ferramenta. Os planos e preços estão em namebeta.com/pt/pricing.

Quando os limites são reiniciados

Os períodos seguem o horário UTC

Os períodos de cota são fixos e alinhados ao UTC, qualquer que seja o seu fuso horário:

• Os limites por hora são reiniciados no início de cada hora UTC: 13:00, 14:00, 15:00 UTC e assim por diante.
• Os limites diários são reiniciados às 00:00 UTC. Isso corresponde às 21:00 do dia anterior em São Paulo e Brasília, às 01:00 em Lisboa (00:00 no inverno), às 08:00 em Pequim, às 09:00 em Tóquio e às 16:00 ou 17:00 do dia anterior em São Francisco.

Os períodos não são móveis. Chamadas feitas às 13:59 UTC e às 14:00 UTC caem em horas diferentes, então a cota por hora completa volta a ficar disponível no início de cada hora UTC.

Acima do limite: 429 e Retry-After

Uma chamada acima de qualquer um dos limites é rejeitada no nível HTTP, antes de chegar à ferramenta:

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
Status	Sempre 429 Too Many Requests, tanto para o limite por hora quanto para o diário
Cabeçalho Retry-After	Segundos até o período excedido ser reiniciado: de 1 a 3.600 no limite por hora, de 1 a 86.400 no diário
error.code	-32000
error.message	MCP hourly quota exceeded. ou MCP daily quota exceeded.
error.data.retryAfter	O mesmo número de segundos de Retry-After
id	O id da sua solicitação

O limite diário é verificado primeiro. Quando os dois limites se esgotam, a resposta informa o diário, e Retry-After aponta para 00:00 UTC; tentar de novo na hora seguinte falharia outra vez.

O que os clientes devem fazer

• Aguarde pelo menos os segundos indicados em Retry-After antes de chamar a mesma ferramenta de novo. Uma nova tentativa antes disso é rejeitada com outro 429.
• As outras categorias não são afetadas. Depois que lookup_whois atinge o limite, lookup_dns e compare_prices continuam funcionando.
• Informe ao usuário quando o limite será reiniciado, em vez de repetir a chamada em loop. No limite diário, a espera pode durar quase um dia inteiro.