MCP Server Pronunciation vs Python Docs MCP Server

retry

Retry the last sentence the user was practicing. Re-records and re-assesses using the same reference text from the previous `practice` or `converse` call. Use this to let the user try again after getting feedback. Args: duration: Maximum recording duration in seconds (default 15, max 120). Returns: Pronunciation assessment report for the new attempt.

quick_practice

Pick a random practice sentence and drill it immediately. Combines `suggest_sentence` + `practice` into one step: picks a sentence matching the criteria, then records and assesses. Args: focus: Phoneme focus area. Options: "th", "f_v", "r_l", "vowels", "general". If not specified, picks randomly. difficulty: Difficulty level. Options: "beginner", "intermediate", "advanced". If not specified, picks randomly. duration: Maximum recording duration in seconds (default 15, max 120). Returns: The sentence to read, followed by the pronunciation assessment.

suggest_sentence

Suggest a practice sentence the user can read aloud. Args: focus: Phoneme focus area. Options: "th", "f_v", "r_l", "vowels", "general". If not specified, picks randomly. difficulty: Difficulty level. Options: "beginner", "intermediate", "advanced". If not specified, picks randomly. Returns: A practice sentence with its focus area and difficulty.

record

Record audio from the microphone without assessing it. Recording auto-stops when the user finishes speaking (silence detection). The duration is the maximum time — you don't have to wait the full duration. Most of the time prefer `converse` or `practice`, which record AND analyze in one step. Only use `record` alone if you want the raw WAV file. Args: duration: Maximum recording duration in seconds (default 10, max 120). Returns: Path to the recorded WAV file.

assess

Assess the last recording (or a specific audio file) without re-recording. When `reference_text` is provided, the assessor: - Aligns the user's speech to the reference word-by-word (Needleman-Wunsch; single deletions/insertions no longer cascade into phantom substitutions). - Runs wav2vec2 CTC forced alignment to verify which reference words the user actually produced — mitigates Whisper-bias mistranscriptions on rare proper nouns and domain terms by checking acoustic evidence against the reference directly. - Surfaces per-word phoneme-level feedback (expected vs produced IPA, weak phonemes) from CMUdict. - Surfaces optional learner-profile pronunciation hints and drills when a rule pack matches. The bundled profile includes Korean-L1 patterns such as r/l, th→s, final cluster deletion, and intrusive onset vowel. - Adds prosody notes: word-stress placement, sentence-final rising intonation on declaratives, intra-clause hesitation pauses. Without a reference, only the transcript and prosody run. Args: reference_text: Expected text the user was trying to say (optional). audio_path: Path to a WAV file. Uses the last recording if not specified. Returns: Detailed pronunciation assessment report (markdown).

check_mic

List available audio input devices and verify microphone access. Use this if the user reports recording problems — it shows which devices are available and which one is the default. Returns: List of available microphone devices.