Allows an AI client to monitor children's learning progress and plan lessons on the anton.app platform.
Also known as udondan/anton, @udondan/anton
- Stars
- 4
- Tools
- 24
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- MIT
What is anton MCP?
anton allows an AI client to monitor children's learning progress and plan lessons on the anton.app platform. It exposes 24 tools, such as get_status, list_groups, get_group.
Summary generated from the project's README
About anton MCP server
Parents and guardians who use the anton.app platform can monitor children's educational development and organize study schedules through this MCP server. It provides an interface for AI clients to access an unofficial API, allowing for the tracking of learning progress, subject performance, and activity timelines. By connecting via an 8-digit parent login code or an internal log ID, users can transform an AI assistant into a specialized educational coordinator.
The server enables specific actions such as listing available courses, searching for topics, and assigning specific lesson blocks to children for upcoming weeks. It also supports local assignment tracking through JSON files for personal notes. This tool is designed strictly for educational support and oversight; it does not include any functionality to automate lesson completion or assist in cheating. Users can configure their credentials using a local config file or environment variables to maintain a persistent connection with the platform.
What you can do with it
- 1Monitor weekly learning progressAsk the AI to summarize how a child performed in their lessons over the past week.
- 2Plan future lessonsInstruct the AI to assign specific math topics to a child for the next school week.
- 3Analyze subject performanceRequest a detailed report on a child's accuracy and trends within a specific subject like mathematics.
- 4Identify learning gapsHave the AI review activity timelines to find periods of inactivity or specific areas needing improvement.
Written from the project's README. Every use case is checked against a quote from it.
How to install anton MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall anton MCP in Claude Code
$ claude mcp add anton -- npx -y @udondan/antonInstall anton MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"anton": {
"command": "npx",
"args": [
"-y",
"@udondan/anton"
]
}
}
}Install anton MCP in VS Code
.vscode/mcp.json
{
"servers": {
"anton": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@udondan/anton"
]
}
}
}Install anton MCP in VS Code CLI
$ code --add-mcp '{"name":"anton","type":"stdio","command":"npx","args":["-y","@udondan/anton"]}'Install anton MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"anton": {
"command": "npx",
"args": [
"-y",
"@udondan/anton"
]
}
}
}Install anton MCP in Codex
$ codex mcp add anton -- npx -y @udondan/antonInstall anton MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.anton] command = "npx" args = ["-y", "@udondan/anton"]
Install anton MCP in Gemini CLI
$ gemini mcp add -s user anton npx -- -y @udondan/antonInstall anton MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"anton": {
"command": "npx",
"args": [
"-y",
"@udondan/anton"
]
}
}
}anton MCP tools 24
Detected from the READMEget_statuslist_groupsget_groupget_group_assignmentspin_blockunpin_blocklist_childrenget_progressget_eventsget_level_progresscheck_assignment_completionget_weekly_summary
| get_status | — | |
| list_groups | — | |
| get_group | — | |
| get_group_assignments | — | |
| pin_block | — | |
| unpin_block | — | |
| list_children | — | |
| get_progress | — | |
| get_events | — | |
| get_level_progress | — | |
| check_assignment_completion | — | |
| get_weekly_summary | — |
Show all 24 toolsShow fewer tools
get_subject_summaryget_activity_timelinecompare_childrenlist_planslist_topicsget_topic_blocksget_planget_lessonlist_assignmentsassign_lessonupdate_assignmentdelete_assignment
| get_subject_summary | — | |
| get_activity_timeline | — | |
| compare_children | — | |
| list_plans | — | |
| list_topics | — | |
| get_topic_blocks | — | |
| get_plan | — | |
| get_lesson | — | |
| list_assignments | — | |
| assign_lesson | — | |
| update_assignment | — | |
| delete_assignment | — |
Configuration
ANTON_GROUPANTON_LOGIN_CODE
| Name | Description | |
|---|---|---|
| ANTON_GROUP | — | |
| ANTON_LOGIN_CODE | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub@udondan/anton

[!NOTE] Inoffizielles Community-Projekt. Nicht mit der solocode GmbH (Anbieter von ANTON) verbunden, nicht von ihr unterstützt oder autorisiert.
Node.js-Paket zur Überwachung des Lernfortschritts von Kindern auf anton.app. Es kapselt die inoffizielle anton.app-API und bietet drei Schnittstellen über einen gemeinsamen Kern:
- SDK — importierbare
Anton-Klasse für Node.js-Projekte - CLI —
anton-Befehl für das Terminal - MCP-Server —
anton mcpstellt alle Funktionen als Tools für KI-Assistenten bereit
Zusätzlich gibt es einen Agent Skill, der KI-Assistenten die Bedienung der CLI beibringt.
[!IMPORTANT] Dieses Paket dient ausschließlich dazu, den Lernfortschritt von Kindern zu verfolgen und Lektionen zu planen — als Unterstützung für Eltern und Erziehungsberechtigte. Es kann nicht dazu genutzt werden, beim Lernen zu schummeln oder Lektionen automatisiert abzuschließen. Das Paket stellt dafür keine Funktionen bereit!
[!WARNING] Dieses Paket nutzt eine inoffizielle, durch Reverse Engineering ermittelte API. Endpunkte können sich jederzeit ohne Vorankündigung ändern.
Inhalt
Installation
# Globale Installation (empfohlen für CLI-Nutzung)
npm install -g @udondan/anton
# Ohne Installation direkt nutzen
ANTON_LOGIN_CODE=DEIN-CODE npx @udondan/anton status
Konfiguration
Config-Datei (empfohlen)
Credentials können dauerhaft in ~/.config/anton/config gespeichert werden. Die Datei darf nicht für Gruppe oder andere lesbar sein (z.B. 0600) – auf POSIX-Systemen wird die Datei mit einer Warnung ignoriert, wenn Gruppe- oder andere-Bits gesetzt sind (chmod 0600 ~/.config/anton/config):
# ~/.config/anton/config
ANTON_LOGIN_CODE=DEIN-CODE
ANTON_GROUP=Family
Die Datei enthält KEY=VALUE-Zeilen. Zeilen, die mit # beginnen, werden als Kommentar ignoriert. Umgebungsvariablen haben Vorrang vor der Config-Datei.
# Datei anlegen und absichern
touch ~/.config/anton/config
chmod 0600 ~/.config/anton/config
Umgebungsvariablen
| Variable | Erforderlich | Beschreibung |
|---|---|---|
ANTON_LOGIN_CODE |
Ja (oder ANTON_LOG_ID) |
Der 8-stellige Eltern-Login-Code aus der Anton-App |
ANTON_LOG_ID |
Alternative zu obigem | Interne Log-ID (z. B. L-...) |
ANTON_GROUP |
Nein | Wählt die Standardgruppe bei mehreren Gruppen (Groß-/Kleinschreibung egal) |
ANTON_ASSIGNMENTS_FILE |
Nein | Pfad zur Aufgaben-JSON-Datei (Standard: ~/.config/anton/assignments.json) |
ANTON_NO_SESSION_CACHE |
Nein | Auf 1 setzen, um den CLI-Session-Cache zu deaktivieren |
SDK
Installation
npm install @udondan/anton
Schnellstart
import { Anton } from '@udondan/anton';
const anton = new Anton({ loginCode: 'DEIN-CODE' });
await anton.connect();
// Authentifizierungs- und Gruppenübersicht
console.log(anton.getStatus());
// Wochenzusammenfassung für ein Kind
console.log(await anton.getWeeklySummary({ childName: 'Emma' }));
API-Referenz
Authentifizierung
const anton = new Anton({ loginCode: 'ABCD-1234' });
// oder
const anton = new Anton({ logId: 'L-...' });
await anton.connect(); // muss vor allen anderen Methoden aufgerufen werden
Status & Gruppe
// Authentifizierungsstatus + Gruppenübersicht (kein Netzwerkaufruf)
anton.getStatus();
// Familienmitglieder + aktuell zugewiesene Blöcke
await anton.getGroup();
// Lernende auflisten
anton.listChildren();
Lektionen zuweisen
// Block per Kurs + Thema + Block zuweisen (wird intern aufgelöst)
await anton.pinBlock({
project: 'c-mat-4',
topicIndex: 6, // 0-basiert, aus listTopics()
blockIndex: 1, // 0-basiert innerhalb des Themas
weekStartAt: '2025-09-01', // Montag; Standard: aktuelle Woche
childName: 'Emma', // weglassen = gesamte Gruppe
});
// Oder Block direkt über PUID angeben
await anton.pinBlock({
blockPuid: 'c-mat-4/ro9ajj',
blockPath: '/../c-mat-4/topic-07-brueche/block-02-brueche-zuordnen/block',
weekStartAt: '2025-09-01',
});
// Zuweisung entfernen
await anton.unpinBlock({
blockPuid: 'c-mat-4/ro9ajj',
weekStartAt: '2025-09-01',
});
// Aktuelle Gruppenzuweisungen abrufen
await anton.getGroupAssignments({ week: '2025-09-01', childPublicId: 'P-...' });
Fortschritt & Ereignisse
// Fortschrittsübersicht (abgeschlossene Level + Sterne)
await anton.getProgress({ childName: 'Emma', since: '2025-01-01' });
// Rohes Ereignisprotokoll
await anton.getEvents({
childName: 'Emma',
eventType: 'finishLevel',
limit: 50,
});
// Performance pro Level (reviewReport-API)
await anton.getLevelProgress({
levelPuid: 'c-mat-4/abc123',
childName: 'Emma',
});
Analysen
// Wochenrückblick: Level, Zeit, Sterne, zugewiesen vs. selbstgewählt
await anton.getWeeklySummary({ childName: 'Emma', weekStartAt: '2025-09-01' });
// Pro Fach: Trefferquote, Sterne, Zeit, Trend
await anton.getSubjectSummary({ childName: 'Emma', subject: 'mat' });
// Aktive Tage, Lernsträhnen, Lücken
await anton.getActivityTimeline({ childName: 'Emma', since: '2025-01-01' });
// Welche zugewiesenen Blöcke hat das Kind abgeschlossen?
await anton.checkAssignmentCompletion({
childName: 'Emma',
week: '2025-09-01',
});
// Alle Kinder im Vergleich
await anton.compareChildren();
Lernkatalog
// ~285 Kurse durchsuchen
await anton.listPlans({ subject: 'mat', grade: 4, language: 'de' });
// Themen eines Kurses (leichtgewichtig — vor getTopicBlocks verwenden)
await anton.listTopics({ project: 'c-mat-4' });
// Blöcke + Level eines einzelnen Themas
await anton.getTopicBlocks({ project: 'c-mat-4', topicIndex: 6 });
// oder per Titel:
await anton.getTopicBlocks({ project: 'c-mat-4', topicTitle: 'Brüche' });
// Vollständige Hierarchie Thema→Block→Level (groß — lieber listTopics + getTopicBlocks)
await anton.getPlan({ project: 'c-mat-4' });
// Lektionsinhalt (Aufgaben, Trainer)
await anton.getLesson({ fileId: 'level/c-mat-4/...' });
Lokale Aufgaben
Lokale Aufgaben werden in einer JSON-Datei gespeichert und sind unabhängig von der anton.app-API — nützlich für eigene Notizen und Tracking.
// Erstellen
const a = anton.assignLesson({
childName: 'Emma',
fileId: 'level/...',
lessonTitle: 'Brüche 1',
});
// Auflisten
anton.listAssignments({ childName: 'Emma', status: 'pending' });
// Aktualisieren
anton.updateAssignment(a.id, {
status: 'completed',
note: 'Auf Anhieb geschafft!',
});
// Löschen
anton.deleteAssignment(a.id);
CLI
[!TIP] Agent Skill verfügbar: Mit dem Agent Skill kennen KI-Assistenten alle Befehle, Flags und den vollständigen Planungsprozess und können direkt
anton-Befehle ausführen.
Einstieg
export ANTON_LOGIN_CODE='DEIN-CODE'
anton status
Befehle
Statusbefehle
anton status # Authentifizierungsinfo + Gruppenübersicht
anton group # Familiengruppe + aktuell zugewiesene Blöcke
anton children # Kinder auflisten
Kursbefehle
anton plans # alle ~285 Kurse
anton plans --subject mat --grade 4 # gefiltert nach Fach und Klasse
anton topics c-mat-4 # Themen eines Kurses
anton blocks c-mat-4 --topic-index 6 # Blöcke eines Themas (per Index)
anton blocks c-mat-4 --topic-title Brüche # Blöcke eines Themas (per Titel)
anton plan c-mat-4 # vollständige Hierarchie (große Ausgabe)
anton lesson level/c-mat-4/... # Lektionsinhalt
Zuweisungsbefehle
# Zuweisung per Thema-/Block-Index
anton pin c-mat-4 --topic-index 6 --block-index 1 --child Emma --week 2025-09-01
# Zuweisung per Titelsuche
anton pin c-mat-4 --topic-title Brüche --block-title "zuordnen" --child Emma
# Aktuelle Gruppenzuweisungen anzeigen
anton pins
anton pins --week 2025-09-01 --child Emma
# Zuweisung entfernen
anton unpin c-mat-4/ro9ajj 2025-09-01
Fortschritt & Analysen
anton progress Emma # alle abgeschlossenen Level + Sterne
anton events Emma --type finishLevel -n 20 # rohes Ereignisprotokoll
anton level-progress c-mat-4/abc123 Emma # Performance pro Level
anton weekly Emma # Zusammenfassung der aktuellen Woche
anton weekly Emma --week 2025-09-01
anton subjects Emma # Trefferquote + Trend pro Fach
anton subjects Emma --subject mat
anton timeline Emma # Lernsträhnen, aktive Tage, Lücken
anton timeline Emma --since 2025-01-01
anton completion Emma # Abschlussstatus zugewiesener Blöcke
anton compare # alle Kinder im Vergleich
Aufgabenverwaltung
anton assign Emma level/c-mat-4/... --title "Brüche 1"
anton assignments --child Emma --status pending
anton update-assignment <id> --status completed
anton delete-assignment <id>
Globale Optionen
anton --no-cache <befehl> # Session-Cache überspringen, immer neu anmelden
Agent Skill für KI-Assistenten
Ein Skill, der KI-Assistenten beibringt, wie man alle anton-CLI-Befehle korrekt verwendet — inklusive Authentifizierung, Befehlssyntax, ID-Ermittlung und wöchentlicher Lernplanung pro Kind.
Skill installieren
npx skills add udondan/anton
Oder global für alle Projekte:
npx skills add udondan/anton -g
Skill verwenden
Sobald der Skill installiert ist, verstehen KI-Assistenten Anfragen wie:
- „Wie hat sich Emma diese Woche in Mathe geschlagen?"
- „Weise Emma und Jonas für nächste Woche passende Lektionen zu."
- „Ich bekomme einen 401-Fehler bei
anton progress— wie behebe ich das?"
Der Assistent wählt automatisch die richtigen anton-Befehle, kennt alle Flags und führt bei Bedarf durch den vollständigen Planungsprozess.
MCP-Server
Der MCP-Server stellt alle 24 Tools über stdio bereit und ermöglicht KI-Assistenten wie Claude, den Lernfortschritt der Kinder zu analysieren und Lektionen automatisch zuzuweisen.
[!TIP] Alternative ohne MCP: KI-Assistenten mit Terminalzugriff können direkt die CLI nutzen. Der Agent Skill bringt ihnen die Befehle bei.
Einrichtung in Claude Code
Mit globaler Installation:
claude mcp add --env ANTON_LOGIN_CODE=DEIN-CODE anton -- anton mcp
Ohne Installation, direkt über npx:
claude mcp add --env ANTON_LOGIN_CODE=DEIN-CODE anton -- npx @udondan/anton mcp
Für eine projektweite Konfiguration (.claude/settings.json):
claude mcp add --scope project --env ANTON_LOGIN_CODE=DEIN-CODE anton -- npx @udondan/anton mcp
Einrichtung in Claude Desktop
Mit globaler Installation — in claude_desktop_config.json:
{
"mcpServers": {
"anton": {
"command": "anton",
"args": ["mcp"],
"env": {
"ANTON_LOGIN_CODE": "DEIN-CODE"
}
}
}
}
Ohne Installation, direkt über npx:
{
"mcpServers": {
"anton": {
"command": "npx",
"args": ["@udondan/anton", "mcp"],
"env": {
"ANTON_LOGIN_CODE": "DEIN-CODE"
}
}
}
}
Anwendungsbeispiele mit Claude
Sobald der MCP-Server eingerichtet ist, kann Claude automatisch auf alle Daten zugreifen und komplexe Aufgaben übernehmen. Hier sind einige Beispiele für Prompts:
Fortschrittsanalyse:
„Wie hat sich Emma diese Woche beim Lernen geschlagen? Welche Fächer laufen gut, wo gibt es Schwächen?"
Claude ruft dabei get_weekly_summary, get_subject_summary und get_activity_timeline ab und liefert eine zusammenhängende Auswertung — Lernzeit, Trefferquoten, Lernsträhnen und Fächer mit Verbesserungs- oder Nachholbedarf.
Automatische Lektionszuweisung basierend auf Lernhistorie:
„Schau dir an, was Emma in Mathematik diese Woche gemacht hat, und weise ihr für nächste Woche die nächsten passenden Lektionen zu."
Claude analysiert dafür:
get_weekly_summary— was wurde diese Woche bearbeitetget_subject_summary— Stärken und Schwächen pro Fachcheck_assignment_completion— wurden die zugewiesenen Blöcke abgeschlossenlist_topics+get_topic_blocks— welche Blöcke kommen als nächstes im Kurspin_block— die nächsten passenden Blöcke direkt zuweisen
Alle Kinder auf einmal versorgen:
„Vergleiche alle Kinder und weise jedem für nächste Woche zwei Lektionen zu, die zu seinem aktuellen Stand passen — bei Schwächen Wiederholungsstoff, sonst das nächste Thema."
Claude nutzt compare_children für den Überblick, analysiert pro Kind die Fachtrends aus get_subject_summary und die Lernhistorie aus get_events, sucht dann in list_topics + get_topic_blocks passende Folgeblöcke oder Wiederholungseinheiten heraus und weist sie per pin_block zu.
Lernrückstand erkennen:
„Hat Emma in letzter Zeit Lernlücken? Wann hat sie zuletzt Mathematik gemacht und gibt es Themen, bei denen sie viele Fehler hatte?"
Claude kombiniert get_activity_timeline (Lücken und Strähnen), get_subject_summary (Fachtrend) und get_events (Fehlerrate pro Lektion), um gezielte Hinweise zu geben.
Wöchentlichen Lernplan erstellen:
„Erstelle für Emma und Jonas je einen Lernplan für die nächsten zwei Wochen — abgestimmt auf ihre bisherigen Fortschritte und offenen Lektionen."
Claude liest für jedes Kind den bisherigen Verlauf, prüft mit check_assignment_completion offene Aufgaben, sucht mit list_topics die nächsten Lernschritte und weist sie wochenweise per pin_block zu.
Verfügbare MCP-Tools
| Tool | Beschreibung |
|---|---|
get_status |
Authentifizierungsstatus, Gruppeninfo, konfigurierte Kinder |
list_groups |
Alle Gruppen, denen der Elternteil angehört |
get_group |
Familienmitglieder + aktuell zugewiesene Blöcke |
get_group_assignments |
Zugewiesene Blöcke, filterbar nach Kind/Woche |
pin_block |
Lektionsblock der Gruppe oder einem Kind zuweisen |
unpin_block |
Zuweisung entfernen |
list_children |
Kinder auflisten |
get_progress |
Abgeschlossene Level + Sterne für ein Kind |
get_events |
Rohes Ereignisprotokoll für ein Kind |
get_level_progress |
Performance pro Level (reviewReport-API) |
check_assignment_completion |
Welche zugewiesenen Blöcke hat ein Kind abgeschlossen |
get_weekly_summary |
Wochenrückblick: Level, Zeit, Sterne |
get_subject_summary |
Pro Fach: Trefferquote, Sterne, Zeit, Trend |
get_activity_timeline |
Aktive Tage, Lernsträhnen, Lücken |
compare_children |
Alle Kinder im Vergleich |
list_plans |
~285 Kurse nach Fach/Klasse durchsuchen |
list_topics |
Thementitel + Indizes für einen Kurs |
get_topic_blocks |
Blöcke + Level für ein einzelnes Thema |
get_plan |
Vollständige Hierarchie Thema→Block→Level |
get_lesson |
Lektionsinhalt (Aufgaben, Trainer) per fileId |
list_assignments |
Lokale Aufgabenliste |
assign_lesson |
Lokale Aufgabe erstellen |
update_assignment |
Lokale Aufgabe aktualisieren |
delete_assignment |
Lokale Aufgabe löschen |
Lizenz
MIT
Disclaimer
Dieses Projekt ist ein inoffizielles, unabhängiges Open-Source-Projekt und steht in keiner Verbindung zur solocode GmbH. ANTON und anton.app sind Produkte bzw. Marken der solocode GmbH. Die Namen werden ausschließlich zur Beschreibung der Kompatibilität verwendet. Die Nutzung erfolgt auf eigenes Risiko und unter Beachtung der Nutzungsbedingungen von ANTON.
anton MCP questions
How do I add anton MCP to Claude Code?
Run claude mcp add anton -- npx -y @udondan/anton in your terminal. Add --scope user to make it available in every project.
How do I add anton MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does anton MCP provide?
It exposes 24 tools, including get_status, list_groups, get_group, get_group_assignments, pin_block.
Can this tool be used to cheat on lessons?
No, the package is strictly for tracking learning progress and planning lessons to support parents and guardians; it does not provide functions to automate or cheat on lessons.
Is this an official product of anton.app?
No, this is an unofficial community project and is not affiliated with, supported by, or authorized by solocode GmbH.