Return the JSON Schema for a site payload, plus a worked example.

Call this before render_site the first time. The schema is permissive: unknown keys are preserved and shown on the page, and an unknown section type degrades to a generic custom section rather than failing.

List every site rendered on this machine, with its URL.

Inspect a rendered site: its sections, decks and learning path.

Set include_payload to get the full stored JSON back — useful when you want to reason about existing content before patching it.

Render a full site and return its URL.

Use this once per site. To change a site afterwards, prefer the add_* and update_* tools — they patch the stored payload in place, so you do not have to resend content that has not changed.

Delete a rendered site and everything under it.

Add a new flashcard deck to a site.

Creates a flashcards section if the site does not have one yet. Cards are reviewed with an SM-2 spaced-repetition schedule in the browser.

Append cards to an existing deck. Markdown works in front and back.

Delete a flashcard deck from a site.

Add prerequisite resources — YouTube videos, blog posts, courses, docs.

Items are merged into the group whose label matches group_label, or a new group is created. YouTube URLs become embedded players. Mark internal wiki links with source="internal" so they are visually distinguished.

Add a section to a site, creating its own page.

An unknown type is rendered as a generic custom section built from its blocks, so you can add kinds of content the schema does not name yet.

Shallow-merge fields into an existing section.

Whole list fields are replaced, not appended — to add to a list, prefer add_flashcards or add_resources.

Remove a section and delete its page.

Reorder sections. Ids you leave out keep their relative order at the end.

Add a numbered step to the learning path on the landing page.

target may be a section id, a page filename, an anchor or a full URL.

Replace the whole learning path.

Update the hero: title, subtitle, summary, repo links, setup command.

Change the site's accent colours and default light/dark mode.