Quotas

Terminologie

• Le quota correspond à l’usage autorisé par votre forfait : chaque outil comptabilisé possède une limite horaire et une limite quotidienne.
• Une catégorie de requêtes (bucket) regroupe un type de consultation, comme whois ou query. Chaque appel d’outil est décompté d’une seule catégorie, et chaque catégorie possède ses propres limites. Le site utilise les mêmes catégories.

Comptabilisation des appels

Les appels MCP sont décomptés du quota de votre forfait NameBeta, dans les mêmes catégories de requêtes que sur le site. Une consultation WHOIS sur namebeta.com et un appel à lookup_whois consomment le même quota. Tous deux apparaissent dans Plan & Usage, dans votre espace personnel.

• Seul tools/call est comptabilisé. initialize, tools/list, ping et les autres requêtes du protocole ne consomment pas de quota.
• Un appel compte pour une unité, quel que soit son contenu. Un appel à check_availability portant sur 20 domaines compte pour un seul appel.
• suggest_domains ne consomme pas de quota, comme les suggestions sur le site.
• L’appel est comptabilisé dès qu’il est accepté, avant l’exécution de l’outil. Un appel qui se termine par une erreur d’outil — domaine invalide, serveur WHOIS qui ne répond pas — est tout de même comptabilisé. Un appel à un outil inconnu ne l’est pas.
• Un appel refusé n’est pas comptabilisé. Lorsque vous dépassez une limite, la réponse 429 ne consomme rien.
• Les limites dépendent de votre forfait. MCP est toujours utilisé avec un compte connecté ; les limites du site pour les utilisateurs anonymes ne s’appliquent donc jamais.

Limites

Un appel doit respecter à la fois la limite horaire et la limite quotidienne de sa catégorie de requêtes.

Outil	Catégorie	Gratuit (heure / jour)	Pro (heure / jour)	Business (heure / jour)	Entreprise (heure / jour)
check_availability avec n'importe quelle étiquette nue	query	90 / 450	360 / 1,800	600 / 3,000	Illimité
check_availability avec uniquement des noms de domaine complets	check	45 / 135	120 / 360	300 / 900	Illimité
compare_prices	single	150 / 250	1,200 / 3,600	2,000 / 8,000	Illimité
suggest_domains	Non compté
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Illimité
lookup_dns	dns	20 / 50	200 / 400	500 / 1,000	Illimité

check_availability est décompté de l’une de deux catégories selon l’entrée ; consultez sa section Quota. Les forfaits et les prix sont présentés sur namebeta.com/fr/pricing.

Réinitialisation des limites

Les périodes sont définies en UTC

Les périodes de quota sont fixes et alignées sur UTC, quel que soit votre fuseau horaire :

• Les limites horaires sont réinitialisées au début de chaque heure UTC : 13 h, 14 h, 15 h UTC, etc.
• Les limites quotidiennes sont réinitialisées à 0 h UTC. Cela correspond à 1 h ou 2 h à Paris selon l’heure d’hiver ou d’été, 8 h à Pékin, 9 h à Tokyo, et 16 h ou 17 h la veille à San Francisco.

Il ne s’agit pas de périodes glissantes. Les appels effectués à 13 h 59 UTC et à 14 h UTC appartiennent à deux heures différentes : l’intégralité du quota horaire redevient donc disponible au début de chaque heure UTC.

Dépassement de limite : 429 et Retry-After

Un appel dépassant l’une des limites est refusé au niveau HTTP, avant d’atteindre l’outil :

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
}

Élément	Valeur
Statut	Toujours 429 Too Many Requests, pour les limites horaires comme quotidiennes
En-tête Retry-After	Nombre de secondes avant la réinitialisation de la période dépassée : de 1 à 3 600 pour la limite horaire, de 1 à 86 400 pour la limite quotidienne
error.code	-32000
error.message	MCP hourly quota exceeded. ou MCP daily quota exceeded.
error.data.retryAfter	Le même nombre de secondes que Retry-After
id	L’id de votre requête

La limite quotidienne est vérifiée en premier. Si les deux limites sont épuisées, la réponse signale la limite quotidienne, et Retry-After indique le délai jusqu’à 0 h UTC. Réessayer à l’heure suivante échouerait à nouveau.

Comportement recommandé pour les clients

• Attendez au moins Retry-After secondes avant de rappeler le même outil. Toute tentative plus précoce est à nouveau refusée avec 429.
• Les autres catégories ne sont pas affectées. Lorsque lookup_whois atteint sa limite, lookup_dns et compare_prices continuent de fonctionner.
• Indiquez à l’utilisateur quand la limite sera réinitialisée au lieu de réessayer en boucle. Pour une limite quotidienne, l’attente peut durer presque une journée.