Skip to main content
Glama

Telesherpa Ontology Platform

by com.telesherpa
OverviewDiscussionsAdmin

register

Konto anlegen — zwei Wege. WEG 1, AGENT (kein Postfach, kein Mensch noetig): register mit agent=true + accept_terms=true. Adresse und Passwort erzeugt die Plattform; beide kommen EINMALIG in der Antwort (username, password), damit meldest du dich per login an. Die Rolle 'member' ist sofort aktiv, keine Mail, kein activate. Ein optionaler invite_code wird sofort uebernommen; ohne Code bist du voellig isoliert (keine Mitgliedschaft, keine fremden Scopes) — Zugang spaeter per redeem_invite_code oder Service Request. KEIN Startguthaben: das Konto startet mit 0 Credits und bezahlt sich selbst — onto_credit_checkout (Karte) oder onto_credit_chargeup (prepaid_code). WEG 2, MENSCH: register mit username (E-Mail), password, password_confirm; dann Aktivierungscode per Mail, danach activate. WICHTIG: mit accept_terms=true bestaetigst du die Nutzungsbedingungen (https://www.telesherpa.com/agb). Nach der Registrierung hast du zwei Wege: (a) einem fremden Scope beitreten (invite_code an redeem_invite_code) oder (b) selbst etwas bauen (ontouser_scope_create) und danach mit create_invite_code Einladungscodes erzeugen, um Menschen und andere Agenten in deinen Scope zu holen. Zugangsdaten kommen NUR EINMAL: username/password sofort dauerhaft speichern (Datei chmod 600 oder Secret-Store) — wer sie nur im Kontext behaelt, steht beim naechsten Start ohne Konto da, und eine Neuregistrierung ist ein neues, leeres Konto. Nach dem login zusaetzlich den refresh_token (30 Tage) ablegen: der holt neue Access-Tokens (10 h) ohne Passwort. Vier Wege zu Guthaben oder Zugang, je mit Werkzeugnamen: (a) EINLADUNG — invite_code bei register oder spaeter redeem_invite_code (Zugang zu einem fremden Scope, kein Guthaben); (b) SELBST ZAHLEN — onto_credit_checkout (gehostete Zahlseite, Karte); (c) PREPAID — onto_credit_chargeup mit prepaid_code; (d) IDEE — ontouser_service_request (kostenlos): beschreibe, was du bauen willst, die Administratoren pruefen es und schicken bei Gefallen einen Prepaid-Code — dieser Weg haengt an der Idee, nicht am Zugang zu einer Kreditkarte. | EN: account, signup, onboarding, self-registration, agent, register

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
agentNoWEG 1 ohne Einladungscode: true = sofort selbst registrieren (kein Postfach, kein Mensch). Das Konto ist danach isoliert — keine Mitgliedschaft, keine fremden Scopes. Nicht mit username/password kombinieren.
passwordNoWEG 2: Passwort
usernameNoWEG 2 (Mensch): E-Mail-Adresse fuer die Registrierung (Aktivierungscode kommt dorthin — der Mensch kann ihn vorlesen, IMAP nicht noetig)
invite_codeNoWEG 1 (Agent), optional: Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Die Scope-Rechte des Codes werden sofort uebernommen; ohne Code bleibt das Konto isoliert. Nicht mit username/password kombinieren.
accept_termsYesPflicht in beiden Wegen. Mit true bestaetigst du die Nutzungsbedingungen (https://www.telesherpa.com/agb). Ohne Zustimmung wird kein Konto angelegt. Lies sie, bevor du zustimmst.
password_confirmNoWEG 2: Passwort-Wiederholung (muss identisch sein)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / agent
      Added value: +{
+  "description": "WEG 1 ohne Einladungscode: true = sofort selbst registrieren (kein Postfach, kein Mensch). Das Konto ist danach isoliert — keine Mitgliedschaft, keine fremden Scopes. Nicht mit username/password kombinieren.",
+  "type": "boolean"
+}
    • changedInput schema / properties / invite_code / description
      Previous value: -"WEG 1 (Agent): Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Zugang und Startguthaben kommen mit dem Code. Nicht mit username/password kombinieren."New value: +"WEG 1 (Agent), optional: Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Die Scope-Rechte des Codes werden sofort uebernommen; ohne Code bleibt das Konto isoliert. Nicht mit username/password kombinieren."
  2. Changed1 schema field changed
    • changedInput schema / properties / invite_code / description
      Previous value: -"WEG 1 (Agent): Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Nicht mit username/password kombinieren."New value: +"WEG 1 (Agent): Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Zugang und Startguthaben kommen mit dem Code. Nicht mit username/password kombinieren."
  3. Changed6 schema fields changed
    • changedInput schema / properties / accept_terms / description
      Previous value: -"Pflicht. Mit true bestaetigst du die Nutzungsbedingungen (https://www.telesherpa.com/agb). Ohne Zustimmung wird kein Konto angelegt. Lies sie, bevor du zustimmst."New value: +"Pflicht in beiden Wegen. Mit true bestaetigst du die Nutzungsbedingungen (https://www.telesherpa.com/agb). Ohne Zustimmung wird kein Konto angelegt. Lies sie, bevor du zustimmst."
    • addedInput schema / properties / invite_code
      Added value: +{
+  "description": "WEG 1 (Agent): Einladungscode von deinem Auftraggeber. Adresse und Passwort erzeugt die Plattform, sie kommen einmalig in der Antwort zurueck. Kein Postfach, keine Mail, kein activate. Nicht mit username/password kombinieren.",
+  "type": "string"
+}
    • changedInput schema / properties / password / description
      Previous value: -"Passwort"New value: +"WEG 2: Passwort"
    • changedInput schema / properties / password_confirm / description
      Previous value: -"Passwort-Wiederholung (muss identisch sein)"New value: +"WEG 2: Passwort-Wiederholung (muss identisch sein)"
    • changedInput schema / properties / username / description
      Previous value: -"E-Mail-Adresse fuer die Registrierung (Aktivierungscode kommt dorthin — der Mensch kann ihn vorlesen, IMAP nicht noetig)"New value: +"WEG 2 (Mensch): E-Mail-Adresse fuer die Registrierung (Aktivierungscode kommt dorthin — der Mensch kann ihn vorlesen, IMAP nicht noetig)"
    • changedInput schema / required
      Previous value: -[
-  "username",
-  "password",
-  "password_confirm",
-  "accept_terms"
-]New value: +[
+  "accept_terms"
+]
  4. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations (readOnlyHint=false, idempotentHint=false, openWorldHint=true): credentials returned only ONCE and must be persisted (chmod 600/secret store), re-registration creates a new empty account, no starting credits, isolated scope without invite_code, refresh_token 30d / access token 10h lifecycle. This is exactly the operational context an agent needs and cannot get from structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with 'Konto anlegen — zwei Wege' and organized into WEG 1/WEG 2/routing sections, which is good. However it is very long and repeats content (credit/access paths are stated inline and again as a four-item list; parameter semantics are echoed from the schema), so several sentences do not earn their place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, and the description compensates by explaining the return payload (username/password returned once) and the downstream token flow. Given a 6-parameter, multi-path registration tool, nothing critical to calling it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds cross-parameter constraints not captured per-property, notably that agent and invite_code must not be combined with username/password, and the consequence of accept_terms. Useful, though much of it mirrors the already-detailed schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (an account anlegen) and immediately frames it as two distinct paths (agent vs human), naming the decisive parameters agent/accept_terms versus username/password. It explicitly distinguishes itself from siblings like activate, login, redeem_invite_code, and onto_credit_checkout, so an agent can tell them apart without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use routing: WEG 1 for agents with no mailbox, WEG 2 for humans with activation mail, plus a four-option decision tree for funding/access (invite, self-pay, prepaid, service request). Alternatives are named by tool, not merely implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Telesherpa Ontology Platform toolsInspect
Try in Browser
Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources