Authoring reference

The itera-mcp server (https://mcp.iterahq.dev/mcp) exposes 21 tools over the lesson model. They are grouped by level.

Accurate to the live server

Tool names and inputs on these pages are taken directly from the iterahq/itera-mcp source (src/tools/*.ts). The set is count-gated in the server’s tests/registration.test.ts (CI fails on drift), and this docs site runs a parity check asserting all 21 names are documented.

The 21 tools at a glance

Level	Tools	Count
Tenants & whoami	list_tenants, whoami	2
Programs	list_programs, get_program, create_program, update_program, delete_program, instantiate_program	6
Units	list_units, create_unit, update_unit, delete_unit	4
Lessons	list_lessons, create_lesson, update_lesson, delete_lesson	4
Activities	list_activities, get_activity, create_activity, update_activity, delete_activity	5

How to read the tool tables

• Inputs are the tool’s real arguments. ? marks optional ones.
• Ids are UUIDs. Each level takes the parent id from the previous create_*.
• Auth: every tool runs as you under RLS. Reads are tenant-scoped; writes (create_* / update_* / delete_* / instantiate_program) require an author / instructor / tenant_admin / owner role on the target tenant.
• Results are JSON. Write tools return { "success": true, "<entity>": {…} }; deletes return { "success": true, "deleted": "<id>" }. Errors come back as { "error": "<message>" } (a caller-visible result, not a thrown exception).

Common error messages

• Conflict: a row with that unique key already exists. — duplicate slug in a tenant (23505).
• Foreign-key violation: …parent row does not exist or is not visible to you. — bad/invisible parent id (23503).
• Permission denied: your role lacks authoring rights for this tenant … — you’re not an author there (42501).
• … not found or you lack authoring rights. — the row doesn’t exist or RLS hides it from you.

Tenants & whoami Resolve a tenant_id and self-check your authoring rights.

Programs The course template: list / get (deep graph) / create / update / delete / instantiate (deep-copy).

Units Sections within a program.

Lessons Classes within a unit.

Activities The ten activity kinds, with spec + rubric.

Reading results (itera-api) Pull-only REST for activity results, progress, and artifacts — per-tenant API key.