Kontingente

Begriffe

• Das Kontingent ist der in Ihrem Tarif enthaltene Nutzungsumfang: Für jedes angerechnete Tool gelten ein stündliches und ein tägliches Limit.
• Eine Abfragekategorie (Bucket) steht für eine Art von Abfrage, etwa whois oder query. Jeder Tool-Aufruf wird genau einer Kategorie angerechnet, und jede Kategorie hat eigene Limits. Abfragen auf der Website werden auf dieselben Kategorien angerechnet.

So werden Aufrufe gezählt

MCP-Aufrufe werden auf Ihren NameBeta-Tarif angerechnet, in denselben Abfragekategorien wie auf der Website. Eine WHOIS-Abfrage auf namebeta.com und ein Aufruf von lookup_whois verbrauchen dasselbe Kontingent. Beide erscheinen unter Tarif & Nutzung in Ihrem Kontobereich.

• Nur tools/call zählt. initialize, tools/list, ping und andere Protokollanfragen verbrauchen kein Kontingent.
• Ein Aufruf zählt einmal, unabhängig vom Inhalt. Ein Aufruf von check_availability mit 20 Domains zählt als ein Aufruf.
• suggest_domains verbraucht kein Kontingent, genau wie die Vorschläge auf der Website.
• Ein Aufruf zählt, sobald er angenommen wird, noch bevor das Tool ausgeführt wird. Auch ein Aufruf, der mit einem Tool-Fehler endet – etwa wegen einer ungültigen Domain oder eines nicht antwortenden WHOIS-Servers –, zählt. Der Aufruf eines unbekannten Tools zählt nicht.
• Ein abgelehnter Aufruf zählt nicht. Wenn Sie ein Limit überschritten haben, verbraucht die 429-Antwort kein Kontingent.
• Ihr Tarif bestimmt die Limits. MCP wird immer von einem angemeldeten Nutzer verwendet. Die Limits für anonyme Nutzer der Website gelten daher nicht.

Limits

Ein Aufruf muss sowohl innerhalb des Stundenlimits als auch innerhalb des Tageslimits seiner Abfragekategorie liegen.

Tool	Abfragekategorie	Kostenlos (Stunde / Tag)	Pro (Stunde / Tag)	Business (Stunde / Tag)	Enterprise (Stunde / Tag)
check_availability mit jedem nackten Label	query	90 / 450	360 / 1,800	600 / 3,000	Unbegrenzt
check_availability nur mit vollständigen Domainnamen	check	45 / 135	120 / 360	300 / 900	Unbegrenzt
compare_prices	single	150 / 250	1,200 / 3,600	2,000 / 8,000	Unbegrenzt
suggest_domains	Nicht gezählt
lookup_whois	whois	5 / 15	60 / 200	150 / 500	Unbegrenzt
lookup_dns	dns	20 / 50	200 / 400	500 / 1,000	Unbegrenzt

check_availability wird je nach Eingabe einer von zwei Abfragekategorien angerechnet; siehe den Abschnitt Kontingent. Tarife und Preise finden Sie auf namebeta.com/de/pricing.

Wann die Limits zurückgesetzt werden

Zeitfenster richten sich nach UTC

Die Kontingente gelten für feste Zeitfenster nach UTC, unabhängig von Ihrer Zeitzone:

• Stundenlimits werden zu jeder vollen UTC-Stunde zurückgesetzt: 13:00, 14:00, 15:00 UTC und so weiter.
• Tageslimits werden um 00:00 UTC zurückgesetzt. Das entspricht 02:00 Uhr in Berlin (im Winter 01:00 Uhr), 08:00 Uhr in Peking, 09:00 Uhr in Tokio und 16:00 oder 17:00 Uhr am Vortag in San Francisco.

Die Zeitfenster sind nicht gleitend. Aufrufe um 13:59 UTC und 14:00 UTC fallen in unterschiedliche Stunden. Zu jeder vollen UTC-Stunde steht Ihnen daher wieder das gesamte Stundenkontingent zur Verfügung.

Limit überschritten: 429 und Retry-After

Ein Aufruf, der eines der Limits überschreitet, wird auf HTTP-Ebene abgelehnt, bevor er das Tool erreicht:

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
}

Bestandteil	Wert
Status	Immer 429 Too Many Requests, sowohl beim Stunden- als auch beim Tageslimit
Retry-After-Header	Sekunden bis zum Ende des überschrittenen Zeitfensters: 1–3.600 beim Stundenlimit, 1–86.400 beim Tageslimit
error.code	-32000
error.message	MCP hourly quota exceeded. oder MCP daily quota exceeded.
error.data.retryAfter	Dieselbe Anzahl Sekunden wie in Retry-After
id	Die id Ihrer Anfrage

Das Tageslimit wird zuerst geprüft. Sind beide Limits ausgeschöpft, meldet die Antwort das Tageslimit, und Retry-After verweist auf 00:00 UTC. Ein erneuter Versuch zur nächsten vollen Stunde würde wieder fehlschlagen.

Empfohlenes Verhalten für Clients

• Warten Sie mindestens Retry-After Sekunden, bevor Sie dasselbe Tool erneut aufrufen. Frühere Versuche werden wieder mit 429 abgelehnt.
• Andere Abfragekategorien sind nicht betroffen. Wenn lookup_whois sein Limit erreicht, funktionieren lookup_dns und compare_prices weiterhin.
• Teilen Sie dem Nutzer mit, wann das Limit zurückgesetzt wird, statt Aufrufe in einer Schleife zu wiederholen. Bei einem Tageslimit kann die Wartezeit fast einen ganzen Tag betragen.