miyagi
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MIYAGI_HOME | No | Override the directory where miyagi stores its profile and history (default is ~/.miyagi). This environment variable can be used to change the data location, and is also how tests keep away from a real profile. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| quick_configC | Instantly switch the target skill level (Junior/Mid/Senior), roadmap category, roadmap track, or topic via simple key-value parameters. |
| set_active_roadmapC | Configure the active roadmap: category, roadmap name, current topic node, and progress step counters. |
| get_next_roadmap_commandB | Suggest the next copy-pasteable terminal command for the active roadmap milestone. Optionally advance the step counter. |
| configure_voiceA | Toggle tutor audio on/off and adjust the speech rate in words per minute. |
| get_user_statsA | Return the current player profile: XP, level, title, quiz streak, unlocked badges, and roadmap progress. |
| run_teaching_commandA | Execute (or dry-run) a shell command and return a full teaching card: roadmap alignment, level-appropriate What/How/Trade-offs, a Mermaid flowchart, pitfalls, curated docs, and an active-recall quiz. Errors return a Tutor Hotfix Diagnostic instead of throwing. |
| verify_quiz_answerA | Evaluate the learner's answer to the most recent active-recall quiz. Updates streak, XP and badges, and speaks feedback. |
| export_roadmap_notesA | Write a clean ROADMAP_PROGRESS.md summary of the session: roadmap position, player stats, and every concept and command covered. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Tools are mostly distinct, but quick_config and set_active_roadmap both handle roadmap configuration, which could cause confusion about which to use for what. Other tools like verify_quiz_answer and run_teaching_command have clear, separate purposes.
Most tools follow a verb_noun snake_case pattern (verify_quiz_answer, set_active_roadmap, get_user_stats), but 'quick_config' deviates with an adjective prefix and lacks a clear noun, breaking the pattern slightly.
Eight tools is well within the ideal range for a focused tutoring server. Each tool covers a distinct aspect of the tutor workflow—config, teaching, quiz, stats, export—with no redundancy or excessive bloat.
The tool set covers core tutor functions: configuration, teaching, assessment, progress tracking, and export. Minor gaps exist, such as no explicit tool to list available topics or manage user preferences beyond voice, but agents can work around these.