For AI agents

Developer reference. An exercise is a link to /app with its settings as query parameters, so an assistant can write one. These files explain the format:

Not a developer? Start here: Practice with an AI assistant

  • /help/ai

    The same, in plain words: ask an assistant for a plan, or connect it to PianoKitty.

  • /mcp

    Where an assistant connects. No login, read-only. Add it in Claude Code with:

    claude mcp add --transport http pianokitty https://pianokitty.com/mcp

  • /help/params.md

    URL params as plaintext Markdown — paste-able into any chatbot.

  • /help/params.json

    The same spec as structured JSON, for tool / function-calling agents.

  • /help/recipes.md

    A cookbook mapping teacher-language tasks to ready-to-open exercise URLs.

  • /help/lists.md

    How to turn a practice plan into one link that fills a list: line syntax, link types, limits and examples.

  • /prompt

    Not building it yourself? Describe what you want to learn and get a prompt for your AI assistant.

  • /llms.txt

    The llms.txt index that points AI crawlers at all of the above.