Brainiall Speech AI - 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 |
| Score how accurately a speaker pronounced a given text (0-100), with per-word and phoneme-level feedback |
| Transcribe speech audio into text with automatic language detection |
| Convert text to natural-sounding speech audio (MP3) |
| List all available text-to-speech voices |
Prerequisites
Get your free API key at app.brainiall.com.
Installation
Using pip
pip install fastmcp httpxUsing Docker
docker build -t brainiall-mcp .
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcpConfiguration
Set the BRAINIALL_API_KEY environment variable:
export BRAINIALL_API_KEY=your-api-keyClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}Cursor / VS Code
Add to your MCP settings:
{
"mcpServers": {
"brainiall-speech-ai": {
"command": "fastmcp",
"args": ["run", "/path/to/server.py"],
"env": {
"BRAINIALL_API_KEY": "your-api-key"
}
}
}
}Streamable HTTP (Docker / Remote)
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcpConnect your MCP client to http://localhost:8000/mcp.
Running Locally
# stdio (default for Claude Desktop / Cursor)
BRAINIALL_API_KEY=your-key fastmcp run server.py
# streamable-http
BRAINIALL_API_KEY=your-key fastmcp run server.py --transport streamable-http --port 8000API 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 |
| string | Yes | Reference text the user should have read |
| string | Yes | Base64-encoded audio (WAV or MP3) |
| string | No | Language code, default |
transcribe_speech
Parameter | Type | Required | Description |
| string | Yes | Base64-encoded audio (WAV, MP3, WEBM, OGG) |
| string | No | Language hint for transcription |
synthesize_speech
Parameter | Type | Required | Description |
| string | Yes | Text to convert to speech |
| string | No | Voice ID, default |
| float | No | Speed multiplier (0.5-2.0), default |
list_voices
No parameters. Returns available voice options with IDs and supported languages.
License
MIT
Links
Brainiall - AI model provider
Get API Key - Sign up and get your free API key