Referenz
TG Validator MCP-Referenz
Mit dem Model Context Protocol können KI-Anwendungen während einer Unterhaltung externe Tools aufrufen. Bitten Sie Ihren Assistenten, eine Nummer zu prüfen oder einen Stapel auszuwerten, ohne eine separate API-Integration zu schreiben.
MCP ist ein Protokolladapter. Es nutzt dieselben Produkte, dasselbe Guthaben, dieselbe Abrechnung, dieselben Parallelitätslimits, Zeitlimits und Ergebnissemantik wie die REST-API.
Authentifizierung
Verwenden Sie genau denselben API-Schlüssel wie für die REST-API und fügen Sie ihn als Bearer-Token in die Konfiguration Ihres MCP-Clients ein.
Authorization: Bearer YOUR_API_KEYHalten Sie Ihren API-Schlüssel privatFügen Sie den Schlüssel nur in die Konfiguration Ihres eigenen, vertrauenswürdigen Clients ein. Legen Sie ihn niemals im Browser-Code oder in öffentlichen Prompts offen.
Server-URL
Richten Sie Ihren Client auf den offiziellen Streamable-HTTP-Endpunkt aus. Ein lokaler MCP-Prozess ist nicht erforderlich.
| Eintrag | Wert |
|---|---|
| MCP-Endpunkt | https://tgvalidator.com/mcp |
| Streamable HTTP | Anfragen verwenden JSON-RPC über Streamable HTTP und dieselbe API-Schlüssel-Middleware wie REST. |
Client verbinden
Wählen Sie das Konfigurationsformat, das Ihr Client unterstützt. Ersetzen Sie den Platzhalter durch Ihren API-Schlüssel.
claude mcp add --transport http tgvalidator https://tgvalidator.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Fügen Sie den Remote-Server über Ihr Terminal hinzu.
Verfügbare Tools
Die Tools sind auf die App beschränkt, zu der Ihr API-Schlüssel gehört. Rufen Sie zuerst list_products auf, wenn Sie gültige Produktcodes ermitteln müssen.
list_products
Listet Produkte, Preise, Abrechnungsmultiplikatoren und Antwortfelder auf.
Keine Parametercheck_number
Prüft eine E.164-Nummer synchron. registered ist das Hauptergebnis.
service_type · string · erforderlich
identifier · string · erforderlichcheck_numbers
Prüft 1–100 Nummern mit einem service_type und behält die Eingabereihenfolge bei.
service_type · string · erforderlich
identifiers · string[] · erforderlich · max. 100get_balance
Liest das aktuelle Kontoguthaben aus, ohne etwas zu berechnen.
Keine ParameterBeispiel-Prompts
Fragen Sie Ihren Assistenten nach der Verbindung in natürlicher Sprache:
Prüfen Sie, ob +17253100591 bei Telegram registriert ist.
Prüfen Sie diese 20 Nummern und fassen Sie die Ergebnisse zusammen.
Wie viel Guthaben ist noch übrig, bevor ich diesen Stapel ausführe?
Fehlerbehandlung
Tool-Fehler verwenden isError=true und denselben code-, msg-, data-Vertrag wie die API.
Beispiel für einen Tool-Fehler
{
"code": 42901,
"msg": "too many concurrent requests",
"data": null
}| Code | Beschreibung |
|---|---|
40000Ungültiges Produkt oder Feld | Nicht unterstützter service_type oder widersprüchliche Felder. |
40002Ungültige Nummer | Die übermittelte Nummer hat kein gültiges Format. |
40100Fehlender oder ungültiger API-Schlüssel | Prüfen Sie den Bearer-Header und stellen Sie sicher, dass der Schlüssel aktiv ist. |
40200Unzureichendes Guthaben | Die Anfrage wird vor der Verarbeitung abgelehnt, wenn der volle Betrag für den Stapel nicht gedeckt werden kann. |
42200Unbestimmt | Die Nummer konnte derzeit nicht bestimmt werden. Es wird kein Ergebnis zurückgegeben, und dieser Aufruf wird nicht berechnet. |
42901Parallelitätsbudget ausgeschöpft | Alle fünf Plätze für gleichzeitige Anfragen sind belegt, oder auf diesem Konto läuft bereits eine Mehrfachprüfung. Nicht berechnet; versuchen Sie es erneut, sobald eine abgeschlossen ist. |
50303Dienst ausgelastet | Plattformweit laufen zu viele Prüfungen. Nicht berechnet; warten Sie die in Retry-After angegebenen Sekunden ab und senden Sie erneut. |
50400Zeitüberschreitung bei der Prüfung | Nicht rechtzeitig abgeschlossen. Nicht berechnet; eine Mehrfachprüfung mit Zeitüberschreitung schlägt als Ganzes fehl und wird vollständig erstattet. |
50300Wartung des Dienstes | Versuchen Sie es später erneut. |