--- title: "REST-API | StudioMeyer Academy" description: "Methoden, Pfade, Zugänge und Schemas aus demselben Vertrag wie der Dienst." canonical: "https://studiomeyer.academy/entwickler/api" language: de markdown_versions: ["https://studiomeyer.academy/entwickler/api.md", "https://studiomeyer.academy/en/entwickler/api.md", "https://studiomeyer.academy/es/entwickler/api.md"] publisher: "StudioMeyer Academy, https://studiomeyer.academy (llms.txt: https://studiomeyer.academy/llms.txt)" --- ## Ein Dienst, zwei Zugänge REST und MCP verwenden denselben Academy-Dienst. Die unten aufklappbaren Operationen kommen aus dessen tatsächlicher Registry. Die Eingabe- und Ausgabeschemas beschreiben die unterstützten Felder; zusätzliche Annahmen aus älteren Entwürfen gelten nicht. - [GET /v1](https://studiomeyer.academy/v1) - [OpenAPI 3.1](https://studiomeyer.academy/v1/openapi.json) ## Antworten lesen Der Umschlag enthält success, result, errors\[\], messages\[\] und request\_id. Listen tragen result\_info mit cursor, has\_more und count. Verwende cursor unverändert für die nächste Seite. links\[\] nennt rel, method und href; folge diesen Links. Inhaltssprache und Fallback stehen in content\_locale und fallback; Version, Status und updated können bei Legacy-Inhalten null sein. ## Sprache und Identität locale=de|en|es hat Vorrang vor Accept-Language; Standard ist de. Fehlende Übersetzungen fallen auf Deutsch zurück und werden als Fallback markiert. Suche verwendet query. Lektionen brauchen lesson:\:\ oder ein explizites level; mehrdeutige Slugs werden abgelehnt. ## Schreiben und Credits Idempotency-Key ist bei POST /v1/me/spend-quotes und bei Credit-Vorgängen Pflicht. Die Vorbereitung erzeugt eine ausstehende Quote ohne Abbuchung; die gesonderte Browser-Freigabe folgt vor der Ausgabe. Derselbe Key darf nicht für andere Eingaben wiederverwendet werden. Schreibende Lernoperationen folgen ihren eigenen idempotenten Verträgen; eine allgemeine Exactly-once-Garantie für alle POSTs wird nicht versprochen. Löschen braucht confirm: true. Bedingungen für optional bezahltes Coaching werden erst anhand der Eingabe entschieden. Kauf und Ausgabe bleiben ohne freigegebene Preise, Credit-Mengen und rechtliche Konfiguration ausgeschaltet (unconfigured). Es gibt keine Testzahlung, die echtes Guthaben erzeugt. Ein Scope allein ist keine Erlaubnis, Credits auszugeben. - [Zugang und Berechtigungen](https://studiomeyer.academy/entwickler/anmeldung) ## Abruflimits Die Tabelle zeigt die aktuellen REST-Buckets. Öffentliche Aufrufe teilen standardmäßig einen konservativen Bucket. Nur ein ausdrücklich konfigurierter, vom vertrauenswürdigen Proxy ersetzter IP-Header trennt anonyme Clients. MCP und OAuth können zusätzliche Transportlimits anwenden. RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset stehen in den Antworten; Reset und Retry-After sind Sekunden. Bucket Limit Fenster (s) Identität anonymous 120 60 shared\_anonymous read 120 60 verified\_principal write 30 60 verified\_principal ## Versionierung /v1 bezeichnet den API-Vertrag; Inhaltsversionen sind davon unabhängig. Entfernte Routen oder Felder, geänderte Feldtypen und neue Pflichtfelder sind inkompatible Änderungen. Optionale Felder und neue Routen können hinzukommen. Prüfe Changelog, OpenAPI und Deprecation-/Sunset-Header. Für bestehende Aliase ist noch kein verbindliches Abschaltdatum veröffentlicht. - [Was sich an der Schnittstelle ändert](https://studiomeyer.academy/changelog) - [Fehler verstehen](https://studiomeyer.academy/entwickler/fehler) ## Zahlungen mit Bestätigung ACP 2026-04-17 verwendet /checkout\_sessions und /.well-known/acp.json. /.well-known/payments.json zeigt, ob freigegebene Angebote, Provider und dauerhafte Speicherung konfiguriert sind. Das ist kein Zahlungsnachweis. POST benötigt Bearer, API-Version und Idempotency-Key; Cookies autorisieren den Agenten-Checkout nicht. Der Mensch prüft und bezahlt bei Stripe. Erst der geprüfte ursprüngliche Zahlungsbeleg erlaubt die einmalige Gutschrift. Ohne Geschäfts- und Rechtsfreigabe werden keine Käufe begonnen. Direkte Kartenzahlung durch den Agenten ist nicht implementiert. - [ACP discovery](https://studiomeyer.academy/.well-known/acp.json) - [Payment readiness](https://studiomeyer.academy/.well-known/payments.json) - [Deine Zahlungen](https://studiomeyer.academy/dashboard/zahlungen) ## Längere Tutor-Anfragen POST /v1/me/tutor/jobs nimmt die gleiche Tutor-Eingabe mit Quote, Browserfreigabe und Idempotency-Key entgegen. 202 Accepted liefert job\_id und status\_url sowie Location und Retry-After. GET /v1/jobs/{id} liest den Stand, ohne Arbeit oder Abbuchungen auszulösen. Nur derselbe Kontoinhaber und OAuth-Grant können den Auftrag lesen. Ein separater Worker prüft die Berechtigung vor der Ausführung erneut. Die Queue endet nach höchstens 15 Minuten, Ergebnisse nach einer Stunde. Unklare Ausgänge werden nicht automatisch erneut ausgeführt. Der ursprüngliche Tutor-Schlüssel verhindert doppelte Ausgaben; der synchrone Weg bleibt unverändert. - [Job capabilities](https://studiomeyer.academy/v1/jobs) - [OpenAPI](https://studiomeyer.academy/v1/openapi.json) ## Öffentliche Suche und Sammelabruf NLWeb 0.55 GET/POST /ask durchsucht ausschließlich freigegebene kostenlose Inhalte, ohne LLM-Aufruf oder Credits. query.text ist auf 2000 Zeichen begrenzt; prefer.limit liegt zwischen 1 und 20. Mit prefer.streaming=true und Accept: text/event-stream folgen start, result, error und complete. Keine Treffer sind eine NO\_RESULTS-Antwort. /schemamap.xml beschreibt die öffentlichen strukturierten Feeds. POST /v1/batch liest maximal 20 öffentliche Item-IDs mit höchstens vier parallelen Abrufen; keine Schreib- oder Spend-Operationen. ``` curl -fsS https://studiomeyer.academy/ask -H "Content-Type: application/json" --data '{"query":{"text":"Was ist ein Prompt?"}}' ``` - [Schema map](https://studiomeyer.academy/schemamap.xml) - [Library llms.txt](https://studiomeyer.academy/dashboard/bibliothek/llms.txt) ## Operationen Einstieg`GET /v1/start` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/start` **MCP-Tools:** `academy_start` **Ältere Namen:** `academy_welcome` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "paths": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "mappingStatus": { "type": "string", "enum": [ "pending", "confirmed" ] }, "mappingNote": { "type": "string" }, "modules": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "lessons": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false } }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "title", "description", "status", "lessons", "originalReferences" ], "additionalProperties": false } }, "recommendedEntry": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false }, { "type": "null" } ] }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "locale", "title", "description", "href", "status", "mappingStatus", "mappingNote", "modules", "recommendedEntry", "originalReferences" ], "additionalProperties": false } }, "links": { "type": "array", "items": { "type": "object", "properties": { "rel": { "type": "string" }, "method": { "type": "string", "enum": [ "GET", "POST", "PATCH", "DELETE" ] }, "href": { "type": "string" } }, "required": [ "rel", "method", "href" ], "additionalProperties": false } } }, "required": [ "paths", "links" ], "additionalProperties": false } ``` Lernwege auflisten`GET /v1/paths` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/paths` **MCP-Tools:** `academy_paths` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "paths": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "mappingStatus": { "type": "string", "enum": [ "pending", "confirmed" ] }, "mappingNote": { "type": "string" }, "modules": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "lessons": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false } }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "title", "description", "status", "lessons", "originalReferences" ], "additionalProperties": false } }, "recommendedEntry": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false }, { "type": "null" } ] }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "locale", "title", "description", "href", "status", "mappingStatus", "mappingNote", "modules", "recommendedEntry", "originalReferences" ], "additionalProperties": false } } }, "required": [ "paths" ], "additionalProperties": false } ``` Lernweg lesen`GET /v1/paths/{pathSlug}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/paths/{pathSlug}` **MCP-Tools:** `academy_path` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pathId": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] } }, "required": [ "pathId" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "path": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "mappingStatus": { "type": "string", "enum": [ "pending", "confirmed" ] }, "mappingNote": { "type": "string" }, "modules": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "planned" ] }, "lessons": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false } }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "title", "description", "status", "lessons", "originalReferences" ], "additionalProperties": false } }, "recommendedEntry": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "id": { "type": "string" }, "href": { "type": "string" }, "status": { "type": "string", "const": "available" }, "originLabel": { "type": "string" }, "originalReference": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "required": [ "level", "slug", "locale", "title", "order", "id", "href", "status", "originLabel", "originalReference" ], "additionalProperties": false }, { "type": "null" } ] }, "originalReferences": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } } }, "required": [ "id", "locale", "title", "description", "href", "status", "mappingStatus", "mappingNote", "modules", "recommendedEntry", "originalReferences" ], "additionalProperties": false }, "confirmedLessons": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "href": { "type": "string" } }, "required": [ "kind", "level", "slug", "locale", "href" ], "additionalProperties": false } }, "moduleMapping": { "type": "string", "enum": [ "pending", "confirmed" ] } }, "required": [ "path", "confirmedLessons", "moduleMapping" ], "additionalProperties": false } ``` Modul lesen`GET /v1/paths/{pathSlug}/modules/{moduleSlug}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/paths/{pathSlug}/modules/{moduleSlug}` **MCP-Tools:** `academy_module` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pathId": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "moduleId": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "pathId", "moduleId" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pathId": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "moduleId": { "type": "string" }, "title": { "type": "string" }, "lessons": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false } } }, "required": [ "pathId", "moduleId", "title", "lessons" ], "additionalProperties": false } ``` Lektion lesen`GET /v1/lessons/{lessonSlug}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/lessons/{lessonSlug}` **MCP-Tools:** `academy_lesson` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "level", "slug", "locale", "title", "order", "body" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Lehrplan für die KI`GET /v1/lessons/{lessonSlug}/teach` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/lessons/{lessonSlug}/teach` **MCP-Tools:** `academy_teach` **Ältere Namen:** `academy_tutor_context` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "lessonId": { "type": "string", "pattern": "^lesson:-?\\d+(?:\\.\\d+)?:[\\s\\S]{0,}$" }, "objectives": { "type": "array", "items": { "type": "string" } }, "steps": { "type": "array", "items": { "type": "string" } }, "exercise": { "type": "string" } }, "required": [ "lessonId", "objectives", "steps", "exercise" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Bibliothek durchsuchen`GET /v1/library` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/library` **MCP-Tools:** `academy_library` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "pathId": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, "access": { "type": "string", "enum": [ "free", "premium" ] } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Prompts auflisten`GET /v1/prompts` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/prompts` - `GET /v1/library/prompts` **MCP-Tools:** `academy_prompts` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Prompt lesen`GET /v1/prompts/{id}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/prompts/{id}` - `GET /v1/library/prompts/{id}` **MCP-Tools:** `academy_prompt` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "playbookId": { "type": [ "string", "null" ] } }, "required": [ "id", "text", "playbookId" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Playbooks auflisten`GET /v1/playbooks` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/playbooks` - `GET /v1/library/playbooks` **MCP-Tools:** `academy_playbooks` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "category": { "type": "string", "minLength": 1, "maxLength": 160 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Glossar auflisten`GET /v1/glossary` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/glossary` - `GET /v1/library/glossary` **MCP-Tools:** `academy_glossary` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "conceptType": { "type": "string", "enum": [ "config_file", "pattern", "tool", "service", "command", "mcp_server", "feature" ] }, "name": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "sourceUrl": { "type": "string" } }, "required": [ "slug", "conceptType", "name", "summary", "body", "tags" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Begriff lesen`GET /v1/glossary/{term}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/glossary/{term}` - `GET /v1/library/glossary/{term}` **MCP-Tools:** `academy_glossary_term` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "term": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "term" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "slug": { "type": "string" }, "conceptType": { "type": "string", "enum": [ "config_file", "pattern", "tool", "service", "command", "mcp_server", "feature" ] }, "name": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "sourceUrl": { "type": "string" } }, "required": [ "slug", "conceptType", "name", "summary", "body", "tags" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Rezepte auflisten`GET /v1/recipes` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/recipes` **MCP-Tools:** `academy_recipes` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "phase": { "type": "integer", "minimum": 1, "maximum": 16 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "slug": { "type": "string" }, "phase": { "type": "integer", "minimum": 1, "maximum": 16 }, "order": { "type": "number" }, "title": { "type": "string" }, "description": { "type": "string" }, "duration": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "published": { "type": "string" }, "updated": { "type": "string" } }, "required": [ "slug", "phase", "order", "title", "description", "duration" ], "additionalProperties": false }, "body": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "number" }, "title": { "type": "string" }, "body": { "type": "string" }, "validatorId": { "type": "string" } }, "required": [ "index", "title", "body" ], "additionalProperties": false } }, "contentHash": { "type": "string" } }, "required": [ "meta", "body", "steps", "contentHash" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Rezept lesen`GET /v1/recipes/{id}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/recipes/{id}` **MCP-Tools:** `academy_recipe` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "slug": { "type": "string" }, "phase": { "type": "integer", "minimum": 1, "maximum": 16 }, "order": { "type": "number" }, "title": { "type": "string" }, "description": { "type": "string" }, "duration": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "published": { "type": "string" }, "updated": { "type": "string" } }, "required": [ "slug", "phase", "order", "title", "description", "duration" ], "additionalProperties": false }, "body": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "number" }, "title": { "type": "string" }, "body": { "type": "string" }, "validatorId": { "type": "string" } }, "required": [ "index", "title", "body" ], "additionalProperties": false } }, "contentHash": { "type": "string" } }, "required": [ "meta", "body", "steps", "contentHash" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Konzepte durchsuchen`GET /v1/concepts` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/concepts` **MCP-Tools:** `academy_concepts` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query": { "type": "string", "maxLength": 160 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "conceptType": { "type": "string", "enum": [ "config_file", "pattern", "tool", "service", "command", "mcp_server", "feature" ] }, "name": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "sourceUrl": { "type": "string" } }, "required": [ "slug", "conceptType", "name", "summary", "body", "tags" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Coaching ansehen`GET /v1/coaching` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/coaching` **MCP-Tools:** `academy_coaching` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "steps": { "type": "array", "items": { "type": "string" } }, "accountHref": { "type": "string" } }, "required": [ "title", "description", "steps", "accountHref" ], "additionalProperties": false } ``` Einladung erstellen`POST /v1/me/invites` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/invites` **MCP-Tools:** `academy_invite` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "url" ], "additionalProperties": false } ``` Bestätigte Weiterleitungen`GET /v1/redirects` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/redirects` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "confirmedRedirects": { "type": "array", "items": { "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "status": { "type": "number", "const": 308 } }, "required": [ "from", "to", "status" ], "additionalProperties": false } } }, "required": [ "confirmedRedirects" ], "additionalProperties": false } ``` Playbook lesen`GET /v1/playbooks/{id}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/playbooks/{id}` - `GET /v1/library/playbooks/{id}` **MCP-Tools:** `academy_playbook` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "type": "object", "properties": { "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "category": { "type": "string" }, "published": { "type": "string" }, "updated": { "type": "string" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "slug", "locale", "title", "order", "body" ], "additionalProperties": false } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Inhalte suchen`GET /v1/search` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/search` **MCP-Tools:** `academy_search, search` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "query": { "type": "string", "minLength": 1, "maxLength": 160 }, "type": { "anyOf": [ { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, { "type": "string", "const": "lesson" } ] }, "pathId": { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] } }, "required": [ "query" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "type": { "type": "string", "const": "lesson" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "const": "lesson" }, "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "level", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "type", "source" ], "additionalProperties": false } ] } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Inhalt anhand der ID lesen`GET /v1/items/{id}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/items/{id}` **MCP-Tools:** `fetch` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "level", "slug", "locale", "title", "order", "body" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "category": { "type": "string" }, "published": { "type": "string" }, "updated": { "type": "string" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "slug", "locale", "title", "order", "body" ], "additionalProperties": false }, { "type": "object", "properties": { "meta": { "type": "object", "properties": { "slug": { "type": "string" }, "phase": { "type": "integer", "minimum": 1, "maximum": 16 }, "order": { "type": "number" }, "title": { "type": "string" }, "description": { "type": "string" }, "duration": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "published": { "type": "string" }, "updated": { "type": "string" } }, "required": [ "slug", "phase", "order", "title", "description", "duration" ], "additionalProperties": false }, "body": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "number" }, "title": { "type": "string" }, "body": { "type": "string" }, "validatorId": { "type": "string" } }, "required": [ "index", "title", "body" ], "additionalProperties": false } }, "contentHash": { "type": "string" } }, "required": [ "meta", "body", "steps", "contentHash" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string" }, "conceptType": { "type": "string", "enum": [ "config_file", "pattern", "tool", "service", "command", "mcp_server", "feature" ] }, "name": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "sourceUrl": { "type": "string" } }, "required": [ "slug", "conceptType", "name", "summary", "body", "tags" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "playbookId": { "type": [ "string", "null" ] } }, "required": [ "id", "text", "playbookId" ], "additionalProperties": false } ] } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Passende Inhalte vorschlagen`POST /v1/suggestions` Berechtigungen Frei Credit-Effekt Keine - `POST /v1/suggestions` **MCP-Tools:** `academy_suggest` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "profile": { "type": "object", "properties": { "goals": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 300 } }, "capabilities": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 300 } }, "environment": { "type": "string", "maxLength": 500 }, "constraints": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 300 } } }, "additionalProperties": false } }, "required": [ "profile" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "suggestions": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false }, "reasons": { "type": "array", "items": { "type": "string" } } }, "required": [ "item", "reasons" ], "additionalProperties": false } } }, "required": [ "suggestions" ], "additionalProperties": false } ``` Eigene Rechte lesen`GET /v1/me/access` Berechtigungen Persönlicher Zugang Credit-Effekt Keine - `GET /v1/me/access` **MCP-Tools:** `academy_my_access` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "scopes": { "type": "array", "items": { "type": "string", "enum": [ "learn:read", "learn:write", "credits:spend" ] } }, "resource": { "type": "string" }, "tools": { "type": "array", "items": { "type": "string" } }, "hint": { "type": "string" } }, "required": [ "scopes", "resource", "tools", "hint" ], "additionalProperties": false } ``` Profil lesen`GET /v1/me/profile` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/profile` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "selectedPath": { "anyOf": [ { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, { "type": "null" } ] } }, "required": [ "locale", "selectedPath" ], "additionalProperties": false } ``` Profil ändern`PATCH /v1/me/profile` Berechtigungen learn:write Credit-Effekt Keine - `PATCH /v1/me/profile` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "selectedPath": { "anyOf": [ { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, { "type": "null" } ] } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "selectedPath": { "anyOf": [ { "type": "string", "enum": [ "loslegen", "ki-im-alltag", "ki-im-job", "fuer-entwickler" ] }, { "type": "null" } ] } }, "required": [ "locale", "selectedPath" ], "additionalProperties": false } ``` Lernstand lesen`GET /v1/me/learning` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/learning` **MCP-Tools:** `academy_my_learning` **Ältere Namen:** `academy_stats` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "completedLessons": { "type": "number" }, "recentCompletions": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "number" }, "lessonSlug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "completedAt": { "type": "string" } }, "required": [ "level", "lessonSlug", "locale", "title", "completedAt" ], "additionalProperties": false } }, "currentStreak": { "type": "number" }, "longestStreak": { "type": "number" }, "streakTimeZone": { "type": "string", "const": "Europe/Berlin" }, "quizCount": { "type": "number" }, "notesCount": { "type": "number" }, "learningPoints": { "type": "object", "properties": { "status": { "type": "string", "const": "unconfigured" }, "value": { "type": "null" } }, "required": [ "status", "value" ], "additionalProperties": false }, "credits": { "type": "object", "properties": { "status": { "type": "string", "const": "unconfigured" }, "bonusCredits": { "type": "null" }, "subscriptionCredits": { "type": "null" }, "euroValue": { "type": "null" }, "spendingEnabled": { "type": "boolean", "const": false }, "purchasesEnabled": { "type": "boolean", "const": false } }, "required": [ "status", "bonusCredits", "subscriptionCredits", "euroValue", "spendingEnabled", "purchasesEnabled" ], "additionalProperties": false } }, "required": [ "completedLessons", "recentCompletions", "currentStreak", "longestStreak", "streakTimeZone", "quizCount", "notesCount", "learningPoints", "credits" ], "additionalProperties": false } ``` Weiterlernen`GET /v1/me/continue` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/continue` **MCP-Tools:** `academy_continue` **Ältere Namen:** `academy_next_lesson` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lesson": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, { "type": "null" } ] }, "href": { "type": [ "string", "null" ] } }, "required": [ "lesson", "href" ], "additionalProperties": false } ``` Lektion abschließen`POST /v1/me/progress/lessons/{lessonSlug}/complete` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/progress/lessons/{lessonSlug}/complete` **MCP-Tools:** `academy_lesson_done` **Ältere Namen:** `academy_progress_complete` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lessonId": { "type": "string", "pattern": "^lesson:-?\\d+(?:\\.\\d+)?:[\\s\\S]{0,}$" }, "completedAt": { "type": "string" }, "firstCompletion": { "type": "boolean" } }, "required": [ "lessonId", "completedAt", "firstCompletion" ], "additionalProperties": false } ``` Notizen lesen`GET /v1/me/notes` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/notes` **MCP-Tools:** `academy_notes` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "lesson": { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "body": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "lesson", "locale", "body", "createdAt", "updatedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Notiz speichern`POST /v1/me/notes` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/notes` **MCP-Tools:** `academy_note_save` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" }, "body": { "type": "string", "minLength": 1, "maxLength": 50000 } }, "required": [ "level", "slug", "body" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "lesson": { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "body": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "lesson", "locale", "body", "createdAt", "updatedAt" ], "additionalProperties": false } ``` Notiz löschen`DELETE /v1/me/notes/{id}` Berechtigungen learn:write Credit-Effekt Keine - `DELETE /v1/me/notes/{id}` **MCP-Tools:** `academy_note_delete` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "confirm": { "type": "boolean", "const": true } }, "required": [ "id", "confirm" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "deleted": { "type": "boolean", "const": true }, "id": { "type": "string" } }, "required": [ "deleted", "id" ], "additionalProperties": false } ``` Quiz lesen`GET /v1/me/quiz/{lessonSlug}` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/quiz/{lessonSlug}` **MCP-Tools:** `academy_quiz` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, { "type": "object", "properties": { "quizSlug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "quizSlug" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "slug" ], "additionalProperties": false, "description": "Deprecated legacy quiz-slug lookup without level; use quizSlug instead.", "deprecated": true } ], "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" }, "quizSlug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } } } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "slug": { "type": "string" }, "kind": { "type": "string", "enum": [ "lesson", "checkpoint" ] }, "level": { "type": "number" }, "lessonSlug": { "type": [ "string", "null" ] }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "passingScore": { "type": "number" }, "questions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "options": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "id", "text" ], "additionalProperties": false } } }, "required": [ "id", "text", "options" ], "additionalProperties": false } } }, "required": [ "slug", "kind", "level", "lessonSlug", "locale", "title", "description", "passingScore", "questions" ], "additionalProperties": false } ``` Quiz abgeben`POST /v1/me/quiz/{lessonSlug}/submissions` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/quiz/{lessonSlug}/submissions` **MCP-Tools:** `academy_quiz_submit` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "quizSlug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" }, "answers": { "type": "object", "propertyNames": { "type": "string", "maxLength": 150 }, "additionalProperties": { "type": "string", "maxLength": 150 } } }, "required": [ "quizSlug", "answers" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "attemptId": { "type": "string" }, "score": { "type": "number" }, "correct": { "type": "number" }, "total": { "type": "number" }, "passed": { "type": "boolean" }, "perQuestion": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "correct": { "type": "boolean" }, "correctAnswer": { "type": "string" }, "explanation": { "type": "string" } }, "required": [ "id", "correct" ], "additionalProperties": false } } }, "required": [ "attemptId", "score", "correct", "total", "passed", "perQuestion" ], "additionalProperties": false } ``` Wiederholungen lesen`GET /v1/me/review` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/review` **MCP-Tools:** `academy_review` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "lesson": { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "dueAt": { "type": "string" }, "intervalDays": { "type": "number" }, "repetitions": { "type": "number" } }, "required": [ "id", "lesson", "locale", "dueAt", "intervalDays", "repetitions" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Wiederholung bewerten`POST /v1/me/review/{cardId}/grade` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/review/{cardId}/grade` **MCP-Tools:** `academy_review_grade` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "grade": { "type": "string", "enum": [ "again", "good", "easy" ] } }, "required": [ "id", "grade" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "lesson": { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" } }, "required": [ "level", "slug" ], "additionalProperties": false }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "dueAt": { "type": "string" }, "intervalDays": { "type": "number" }, "repetitions": { "type": "number" } }, "required": [ "id", "lesson", "locale", "dueAt", "intervalDays", "repetitions" ], "additionalProperties": false } ``` Installationsplan erstellen`POST /v1/me/installs` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/installs` **MCP-Tools:** `academy_install` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "packageIds": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "existingLockfile": { "type": "object", "properties": { "schemaVersion": { "type": "number", "const": 1 }, "entries": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.-]+)?$" }, "status": { "type": "string", "enum": [ "draft", "candidate", "active" ] }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "license": { "type": "string", "minLength": 1 }, "source": { "type": "string", "format": "uri" }, "installedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "version", "status", "access", "sha256", "license", "source", "installedAt" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "entries" ], "additionalProperties": false }, "observedFiles": { "maxItems": 20000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "relativePath": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[a-zA-Z0-9_.-]+(?:\\/[a-zA-Z0-9_.-]+)*$" }, "sha256": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] } }, "required": [ "id", "relativePath", "sha256" ], "additionalProperties": false } }, "consentDraft": { "type": "boolean" }, "consentCandidate": { "type": "boolean" }, "consentScripts": { "type": "boolean" } }, "required": [ "packageIds" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "status": { "type": "string", "const": "plan" }, "files": { "type": "array", "items": { "type": "object", "properties": { "relativePath": { "type": "string" }, "content": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "executable": { "type": "boolean" } }, "required": [ "relativePath", "content", "sha256", "executable" ], "additionalProperties": false } }, "lockfile": { "type": "object", "properties": { "schemaVersion": { "type": "number", "const": 1 }, "entries": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.-]+)?$" }, "status": { "type": "string", "enum": [ "draft", "candidate", "active" ] }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "license": { "type": "string", "minLength": 1 }, "source": { "type": "string", "format": "uri" }, "installedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "version", "status", "access", "sha256", "license", "source", "installedAt" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "entries" ], "additionalProperties": false } }, "required": [ "status", "files", "lockfile" ], "additionalProperties": false } ``` Verfolgte Installationspläne lesen`GET /v1/me/installs` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/installs` **MCP-Tools:** `academy_installs` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.-]+)?$" }, "status": { "type": "string", "enum": [ "draft", "candidate", "active" ] }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "license": { "type": "string", "minLength": 1 }, "source": { "type": "string", "format": "uri" }, "installedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "version", "status", "access", "sha256", "license", "source", "installedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Updates prüfen`POST /v1/me/installs/check-updates` Berechtigungen learn:read Credit-Effekt Keine - `POST /v1/me/installs/check-updates` **MCP-Tools:** `academy_check_updates` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lockfile": { "type": "object", "properties": { "schemaVersion": { "type": "number", "const": 1 }, "entries": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.-]+)?$" }, "status": { "type": "string", "enum": [ "draft", "candidate", "active" ] }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "license": { "type": "string", "minLength": 1 }, "source": { "type": "string", "format": "uri" }, "installedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "version", "status", "access", "sha256", "license", "source", "installedAt" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "entries" ], "additionalProperties": false }, "observedFiles": { "maxItems": 20000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "relativePath": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^[a-zA-Z0-9_.-]+(?:\\/[a-zA-Z0-9_.-]+)*$" }, "sha256": { "anyOf": [ { "type": "string", "pattern": "^[a-f0-9]{64}$" }, { "type": "null" } ] } }, "required": [ "id", "relativePath", "sha256" ], "additionalProperties": false } } }, "required": [ "lockfile" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "updates": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "fromVersion": { "type": "string" }, "toVersion": { "type": "string" }, "localChanges": { "type": "boolean", "const": false }, "verification": { "type": "string", "const": "unchanged" } }, "required": [ "id", "fromVersion", "toVersion", "localChanges", "verification" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string" }, "fromVersion": { "type": "string" }, "toVersion": { "type": "string" }, "localChanges": { "type": "boolean", "const": true }, "verification": { "type": "string", "const": "modified" } }, "required": [ "id", "fromVersion", "toVersion", "localChanges", "verification" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string" }, "fromVersion": { "type": "string" }, "toVersion": { "type": "string" }, "localChanges": { "type": "null" }, "verification": { "type": "string", "const": "unverified" } }, "required": [ "id", "fromVersion", "toVersion", "localChanges", "verification" ], "additionalProperties": false } ] } } }, "required": [ "updates" ], "additionalProperties": false } ``` Rückmeldung speichern`POST /v1/me/feedback` Berechtigungen learn:write Credit-Effekt Keine - `POST /v1/me/feedback` **MCP-Tools:** `academy_feedback` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "itemId": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "disposition": { "type": "string", "enum": [ "uebernommen", "angepasst", "verworfen" ] }, "text": { "type": "string", "maxLength": 10000 } }, "required": [ "itemId", "disposition" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "savedAt": { "type": "string" } }, "required": [ "id", "savedAt" ], "additionalProperties": false } ``` Konkrete Credit-Ausgabe vorbereiten`POST /v1/me/spend-quotes` Berechtigungen learn:write, credits:spend Credit-Effekt Keine - `POST /v1/me/spend-quotes` **MCP-Tools:** `academy_prepare_spend` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "purpose": { "type": "string", "const": "PREMIUM" }, "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "purpose", "id" ], "additionalProperties": false }, { "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" }, "purpose": { "type": "string", "const": "TUTOR" }, "message": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "level", "slug", "purpose", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "purpose": { "type": "string", "const": "COACHING" }, "topic": { "type": "string", "minLength": 1, "maxLength": 4000 }, "format": { "type": "string", "minLength": 1, "maxLength": 120 }, "preferredTime": { "type": "string", "maxLength": 240 } }, "required": [ "purpose", "topic", "format" ], "additionalProperties": false } ], "type": "object" } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "contentId": { "type": "string" }, "contentVersion": { "type": "string" }, "priceVersion": { "type": "string" }, "credits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string" } }, "required": [ "id", "contentId", "contentVersion", "priceVersion", "credits", "expiresAt" ], "additionalProperties": false } ``` Premium-Katalog lesen`GET /v1/premium` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/premium` **MCP-Tools:** `academy_premium_catalog` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Premium-Vorschau lesen`GET /v1/premium/{id}` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/premium/{id}` - `GET /v1/premium/{id}/preview` **MCP-Tools:** `academy_premium_preview` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "item": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "prompt", "playbook", "skill", "tool", "agent", "guide", "glossary" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "href": { "type": "string" }, "access": { "type": "string", "enum": [ "free", "premium" ] }, "creditPrice": { "type": [ "number", "null" ] }, "euroPrice": { "type": [ "number", "null" ] }, "categories": { "type": "array", "items": { "type": "string" } }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "contentLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "translationPending": { "type": "boolean" }, "source": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "playbook", "concept" ] }, "slug": { "type": "string" }, "href": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind", "slug", "href", "label" ], "additionalProperties": false } }, "required": [ "id", "type", "title", "description", "href", "access", "creditPrice", "euroPrice", "categories", "locale", "contentLocale", "translationPending", "source" ], "additionalProperties": false }, "price": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "unconfigured" }, "quote": { "type": "null" } }, "required": [ "status", "quote" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "configured" }, "quote": { "type": "object", "properties": { "id": { "type": "string" }, "contentId": { "type": "string" }, "contentVersion": { "type": "string" }, "priceVersion": { "type": "string" }, "credits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string" } }, "required": [ "id", "contentId", "contentVersion", "priceVersion", "credits", "expiresAt" ], "additionalProperties": false } }, "required": [ "status", "quote" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "configured" }, "quote": { "type": "null" }, "credits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "contentVersion": { "type": "string" }, "priceVersion": { "type": "string" }, "loginHref": { "type": "string" } }, "required": [ "status", "quote", "credits", "contentVersion", "priceVersion", "loginHref" ], "additionalProperties": false } ] }, "preview": { "type": "string" } }, "required": [ "item", "price", "preview" ], "additionalProperties": false } ``` Credits-Stand lesen`GET /v1/me/credits` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/credits` **MCP-Tools:** `academy_credits` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "unconfigured" }, "bonusCredits": { "type": "null" }, "subscriptionCredits": { "type": "null" }, "euroValue": { "type": "null" }, "spendingEnabled": { "type": "boolean", "const": false }, "purchasesEnabled": { "type": "boolean", "const": false } }, "required": [ "status", "bonusCredits", "subscriptionCredits", "euroValue", "spendingEnabled", "purchasesEnabled" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "configured" }, "balances": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "BONUS", "SUBSCRIPTION", "PURCHASED" ] }, "credits": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "source", "credits" ], "additionalProperties": false } }, "spendingEnabled": { "type": "boolean" }, "purchasesEnabled": { "type": "boolean" } }, "required": [ "status", "balances", "spendingEnabled", "purchasesEnabled" ], "additionalProperties": false } ] } ``` Buchungen lesen`GET /v1/me/credits/ledger` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/credits/ledger` **MCP-Tools:** `academy_ledger` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "source": { "type": "string", "enum": [ "BONUS", "SUBSCRIPTION", "PURCHASED" ] }, "kind": { "type": "string", "enum": [ "GRANT", "SPEND", "REVERSAL" ] }, "status": { "type": "string", "enum": [ "BLOCKED", "POSTED", "VOIDED" ] }, "purpose": { "anyOf": [ { "type": "string", "enum": [ "PREMIUM", "TUTOR", "COACHING" ] }, { "type": "null" } ] }, "amountCredits": { "type": [ "number", "null" ] }, "postedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "source", "kind", "status", "purpose", "amountCredits", "postedAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Premium freischalten`POST /v1/me/premium/{id}/unlock` Berechtigungen credits:spend Credit-Effekt Ausgabe mit Zustimmung - `POST /v1/me/premium/{id}/unlock` **MCP-Tools:** `academy_premium_unlock` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" }, "consent": { "type": "object", "properties": { "userConfirmed": { "type": "boolean", "const": true }, "quoteId": { "type": "string", "minLength": 1, "maxLength": 240 }, "maximumCredits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "userConfirmed", "quoteId", "maximumCredits" ], "additionalProperties": false } }, "required": [ "id", "consent" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "entitlement": { "type": "object", "properties": { "contentId": { "type": "string" }, "grantedAt": { "type": "string" }, "expiresAt": { "type": [ "string", "null" ] } }, "required": [ "contentId", "grantedAt", "expiresAt" ], "additionalProperties": false }, "ledgerEntryId": { "type": "string" } }, "required": [ "entitlement", "ledgerEntryId" ], "additionalProperties": false } ``` Freigeschaltete Inhalte auflisten`GET /v1/me/premium` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/premium` **MCP-Tools:** `academy_my_premium` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "maxLength": 2048 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "contentId": { "type": "string" }, "grantedAt": { "type": "string" }, "expiresAt": { "type": [ "string", "null" ] } }, "required": [ "contentId", "grantedAt", "expiresAt" ], "additionalProperties": false } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ], "additionalProperties": false } ``` Freigeschalteten Inhalt lesen`GET /v1/me/premium/{id}` Berechtigungen learn:read Credit-Effekt Keine - `GET /v1/me/premium/{id}` **MCP-Tools:** `academy_premium_read` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9:_.-]*$" } }, "required": [ "id" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "requestedLocale": { "type": "string", "enum": [ "de", "en", "es" ] }, "content_locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "fallback": { "type": "boolean" }, "version": { "type": [ "string", "null" ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "candidate", "active", "deprecated" ] }, { "type": "null" } ] }, "updated": { "type": [ "string", "null" ] }, "content": { "anyOf": [ { "type": "object", "properties": { "level": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "preview": { "type": "boolean" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "level", "slug", "locale", "title", "order", "body" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "order": { "type": "number" }, "duration": { "type": "string" }, "category": { "type": "string" }, "published": { "type": "string" }, "updated": { "type": "string" }, "bodyPending": { "type": "boolean" }, "bodyLocale": { "type": "string" }, "body": { "type": "string" } }, "required": [ "slug", "locale", "title", "order", "body" ], "additionalProperties": false }, { "type": "object", "properties": { "meta": { "type": "object", "properties": { "slug": { "type": "string" }, "phase": { "type": "integer", "minimum": 1, "maximum": 16 }, "order": { "type": "number" }, "title": { "type": "string" }, "description": { "type": "string" }, "duration": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "published": { "type": "string" }, "updated": { "type": "string" } }, "required": [ "slug", "phase", "order", "title", "description", "duration" ], "additionalProperties": false }, "body": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "number" }, "title": { "type": "string" }, "body": { "type": "string" }, "validatorId": { "type": "string" } }, "required": [ "index", "title", "body" ], "additionalProperties": false } }, "contentHash": { "type": "string" } }, "required": [ "meta", "body", "steps", "contentHash" ], "additionalProperties": false }, { "type": "object", "properties": { "slug": { "type": "string" }, "conceptType": { "type": "string", "enum": [ "config_file", "pattern", "tool", "service", "command", "mcp_server", "feature" ] }, "name": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "sourceUrl": { "type": "string" } }, "required": [ "slug", "conceptType", "name", "summary", "body", "tags" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "playbookId": { "type": [ "string", "null" ] } }, "required": [ "id", "text", "playbookId" ], "additionalProperties": false } ] } }, "required": [ "id", "requestedLocale", "content_locale", "fallback", "version", "status", "updated", "content" ], "additionalProperties": false } ``` Tutor fragen`POST /v1/me/tutor` Berechtigungen learn:write, credits:spend Credit-Effekt Ausgabe mit Zustimmung - `POST /v1/me/tutor` - `POST /v1/me/tutor/messages` **MCP-Tools:** `academy_tutor` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 }, "slug": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^[a-z0-9][a-z0-9_.-]*$" }, "message": { "type": "string", "minLength": 1, "maxLength": 2000 }, "consent": { "type": "object", "properties": { "userConfirmed": { "type": "boolean", "const": true }, "quoteId": { "type": "string", "minLength": 1, "maxLength": 240 }, "maximumCredits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "userConfirmed", "quoteId", "maximumCredits" ], "additionalProperties": false } }, "required": [ "level", "slug", "message", "consent" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "messageId": { "type": "string" }, "response": { "type": "string" }, "ledgerEntryId": { "type": "string" } }, "required": [ "messageId", "response", "ledgerEntryId" ], "additionalProperties": false } ``` Coaching anfragen`POST /v1/me/coaching` Berechtigungen learn:write Credit-Effekt Abhängig von der Eingabe - `POST /v1/me/coaching` **MCP-Tools:** `academy_coaching_request` ### Tool-Eigenschaften ``` { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "topic": { "type": "string", "minLength": 1, "maxLength": 4000 }, "format": { "type": "string", "minLength": 1, "maxLength": 120 }, "preferredTime": { "type": "string", "maxLength": 240 }, "confirm": { "type": "boolean", "const": true }, "payment": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "credits" }, "consent": { "type": "object", "properties": { "userConfirmed": { "type": "boolean", "const": true }, "quoteId": { "type": "string", "minLength": 1, "maxLength": 240 }, "maximumCredits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "userConfirmed", "quoteId", "maximumCredits" ], "additionalProperties": false } }, "required": [ "kind", "consent" ], "additionalProperties": false } ] } }, "required": [ "topic", "format", "confirm", "payment" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "const": "saved" }, "payment": { "type": "string", "enum": [ "none", "posted" ] } }, "required": [ "id", "status", "payment" ], "additionalProperties": false } ``` Bisherige Level auflisten`GET /v1/legacy/levels` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/legacy/levels` **MCP-Tools:** `academy_legacy_levels` **Ältere Namen:** `academy_levels` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "levels": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "number" }, "title": { "type": "string" }, "href": { "type": "string" }, "lessonCount": { "type": "number" } }, "required": [ "level", "title", "href", "lessonCount" ], "additionalProperties": false } } }, "required": [ "levels" ], "additionalProperties": false } ``` Bisherige Lektionen auflisten`GET /v1/legacy/levels/{level}/lessons` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/legacy/levels/{level}/lessons` **MCP-Tools:** `academy_legacy_lessons` **Ältere Namen:** `academy_lessons` ### Tool-Eigenschaften ``` { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } ``` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "level": { "type": "integer", "minimum": 1, "maximum": 6 } }, "required": [ "level" ], "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "lessons": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^lesson:-?\\d+(?:\\.\\d+)?:[\\s\\S]{0,}$" }, "level": { "type": "number" }, "slug": { "type": "string" }, "locale": { "type": "string", "enum": [ "de", "en", "es" ] }, "title": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "href": { "type": "string" } }, "required": [ "id", "level", "slug", "locale", "title", "description", "href" ], "additionalProperties": false } } }, "required": [ "lessons" ], "additionalProperties": false } ``` Freigegebene Kaufangebote lesen`GET /v1/commerce/offers` Berechtigungen Frei Credit-Effekt Keine - `GET /v1/commerce/offers` ### Eingabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ``` ### Ausgabe-Schema ``` { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "configured" }, "merchant": { "type": "string", "minLength": 1, "maxLength": 240 }, "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 240 }, "version": { "type": "string", "minLength": 1, "maxLength": 240 }, "title": { "type": "string", "minLength": 1, "maxLength": 240 }, "kind": { "type": "string", "enum": [ "credit_pack", "subscription" ] }, "amountCents": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[a-z]{3}$" }, "credits": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "interval": { "anyOf": [ { "type": "string", "enum": [ "month", "year" ] }, { "type": "null" } ] } }, "required": [ "id", "version", "title", "kind", "amountCents", "currency", "credits", "interval" ], "additionalProperties": false } }, "termsUrl": { "type": "string", "format": "uri" }, "privacyUrl": { "type": "string", "format": "uri" } }, "required": [ "status", "merchant", "offers", "termsUrl", "privacyUrl" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "unconfigured" }, "merchant": { "type": "null" }, "offers": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "termsUrl": { "type": "null" }, "privacyUrl": { "type": "null" } }, "required": [ "status", "merchant", "offers", "termsUrl", "privacyUrl" ], "additionalProperties": false } ] } ``` ## Sitemap Öffentliche Seiten dieser Website als Markdown: [Sitemap](https://studiomeyer.academy/sitemap.md). Kuratierter Einstieg: [llms.txt](https://studiomeyer.academy/llms.txt), Volltext: [llms-full.txt](https://studiomeyer.academy/llms-full.txt).