# Pronunciation Assessment

Analyze spoken language to provide immediate feedback on pronunciation accuracy and fluency. Identify specific phonetic errors to help learners improve their speaking skills in real-time. Guide users…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add fabiosuizu/pronunciation-assessment

# Browse available tools
npx -y @smithery/cli@latest tool list fabiosuizu/pronunciation-assessment

# Get full schema for a tool
npx -y @smithery/cli@latest tool get fabiosuizu/pronunciation-assessment assess_pronunciation

# Call a tool
npx -y @smithery/cli@latest tool call fabiosuizu/pronunciation-assessment assess_pronunciation '{}'
```

## Direct MCP Connection

Endpoint: `https://pronunciation-assessment--fabiosuizu.run.tools`

**Required config:**
- `apiKey` (query) — Your APIM subscription key

## Tools (10)

- `assess_pronunciation` — Assess English pronunciation quality from audio.
- `check_pronunciation_service` — Check if the pronunciation assessment service is healthy and ready.
- `get_phoneme_inventory` — Get the full phoneme inventory supported by the pronunciation scorer.
- `transcribe_audio` — Transcribe audio to text with word-level timestamps.
- `check_stt_service` — Check if the speech-to-text service is healthy and ready.
- `synthesize_speech` — Generate natural speech audio from English text.
- `list_tts_voices` — List all available text-to-speech voices with metadata.
- `check_tts_service` — Check if the text-to-speech service is healthy and ready.
- `transcribe_audio_pro` — Transcribe audio with Whisper Large V3 Turbo — multilingual STT.
- `check_whisper_service` — Check if the Whisper STT Pro service is healthy and ready.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get fabiosuizu/pronunciation-assessment <tool-name>
```

## Resources

- `pronunciation://scoring-guide` — How pronunciation scores work at each granularity level.
- `pronunciation://audio-requirements` — Supported audio formats, quality requirements, and recording tips.
- `whisper://usage-guide` — How to use the Whisper STT Pro multilingual transcription service.
- `pronunciation://model-info` — Performance benchmarks and service characteristics.
- `pronunciation://response-schema` — Full API response structure with field descriptions.
- `pronunciation://example-assessment` — Real example showing how to interpret a pronunciation assessment.
- `stt://usage-guide` — How to use the speech-to-text transcription service.
- `tts://usage-guide` — How to use the text-to-speech synthesis service.

## Prompts (3)

- `analyze_pronunciation` (assessment_json) — Analyze pronunciation assessment results and provide actionable feedback.
- `create_improvement_plan` (assessment_json, learner_level) — Create a structured pronunciation improvement plan based on assessment results.
- `compare_attempts` (attempt1_json, attempt2_json) — Compare two pronunciation attempts of the same text to track progress.
