Python Docs MCP Server vs MCP Server Pronunciation

converse

Record the user speaking, transcribe it, and return the transcript plus quick English feedback. This is the primary tool for voice conversations: call it, read the transcript + feedback, then respond conversationally in your own words — weaving the feedback in naturally or mentioning it only if it matters. Recording auto-stops when the user finishes speaking (silence detection). Use this tool when: - The user wants to chat with you by voice instead of typing - The user wants casual English feedback while talking with you - You want to hear what the user said rather than read a typed message For a focused drill where the user reads a specific sentence, use `practice` instead. Args: target_hint: Optional. Only set this if the user is explicitly trying to say a specific sentence (e.g. they asked "how do I say X?" and you told them X). Leave blank for free-form conversation. duration: Maximum recording duration in seconds (default 30, max 120). Auto-stops earlier on silence. Returns: Markdown report containing the user's transcript, brief English feedback (pronunciation + grammar + fluency), and a 'For Claude' section with guidance on how to respond.

practice

Drill mode: the user reads a specific sentence aloud and gets a detailed pronunciation assessment. Use this when the user explicitly wants to practice reading a particular sentence, not for free-form chat. For voice conversation with casual feedback, use `converse` instead. Recording auto-stops when the user finishes speaking. Args: reference_text: The sentence the user will read aloud. duration: Maximum recording duration in seconds (default 15, max 120). Returns: Detailed pronunciation assessment report.

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.