SDK, CLI, and MCP server for anton.app — track children's learning progress, browse lessons, manage assignments
Anton exposes 24 tools with basic naming and descriptions, but lacks critical schema rigor. All tools have descriptions (10-80 chars, mostly under 100), but parameter schemas are sparse and inconsistent. Most tools accept 0-2 parameters with minimal type info. No output schemas documented. Error handling is absent, tools return raw API responses without recovery guidance. Naming is verb-noun (status, groups, pins, plan, lesson) but many are generic (status, groups, compare). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Parameter descriptions exist but lack format/constraint details (e.g., 'week' accepts 'YYYY-MM-DD Monday' but no validation guidance). No pagination documented despite tools like 'plans' and 'events' returning lists. Overall: functional but well below production baseline (194 char avg description, 100% param coverage expected for A-grade tools).
Create a local assignment
Local assignment list
List blocks in a topic
List children in the family group
Side-by-side child comparison
Assignment completion status
Delete a local assignment
Raw event log for a child
No output schemas documented. Tools return raw API responses without field definitions, forcing LLMs to infer structure and risking parsing errors.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). LLMs cannot infer safety properties.
Parameter descriptions lack format constraints. 'week' accepts 'YYYY-MM-DD Monday' but no validation guidance; 'child' accepts 'name or public ID' but no disambiguation. LLMs cannot self-correct invalid input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
Show family group details and currently pinned blocks
List all groups the parent account belongs to, with their members
Lesson content
Per-level performance
Assign a lesson block to the group or a specific child
List lesson blocks currently pinned (assigned) to the group
Full topic→block→level hierarchy
Browse lesson catalogue
Progress summary for a child
Show authentication and family group status
Per-subject accuracy and trend
Active days, streaks, gaps
List topics for a course
Remove a pinned block
Update a local assignment
Weekly activity summary
No pagination guidance for list-returning tools (plans, topics, blocks, events, assignments). No limit, offset, or cursor parameters documented. Large result sets risk context window exhaustion.
No error handling or recovery guidance. Tools provide no actionable error messages, recovery steps, or alternative suggestions when operations fail.