fasuizu-br/brainiall-mcp-server

MCP server providing AI-powered pronunciation assessment, speech-to-text, and text-to-speech tools via Brainiall Speech AI APIs.
Tools
| Tool | Description |
|------|-------------|
| assess_pronunciation | Score how accurately a speaker pronounced a given text (0-100), with per-word and phoneme-level feedback |
| transcribe_speech | Transcribe speech audio into text with automatic language detection |
| synthesize_speech | Convert text to natural-sounding speech audio (MP3) |
| list_voices | List all available text-to-speech voices |
Prerequisites
Get your free API key at **app.brainiall.com**.
Installation
Using pip
Using Docker
Configuration
Set the BRAINIALL_API_KEY environment variable:
Claude Desktop
Add to your claude_desktop_config.json:
Cursor / VS Code
Add to your MCP settings:
Streamable HTTP (Docker / Remote)
Connect your MCP client to http://localhost:8000/mcp.
Running Locally
API Reference
All tools communicate with the Brainiall Speech AI API at https://api.brainiall.com. Full API documentation is available at app.brainiall.com.
assess_pronunciation
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| text | string | Yes | Reference text the user should have read |
| audio_base64 | string | Yes | Base64-encoded audio (WAV or MP3) |
| language | string | No | Language code, default en-US |
transcribe_speech
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| audio_base64 | string | Yes | Base64-encoded audio (WAV, MP3, WEBM, OGG) |
| language | string | No | Language hint for transcription |
synthesize_speech
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| text | string | Yes | Text to convert to speech |
| voice | string | No | Voice ID, default alloy |
| speed | float | No | Speed multiplier (0.5-2.0), default 1.0 |
list_voices
No parameters. Returns available voice options with IDs and supported languages.