README.md
AI-powered pronunciation assessment, speech-to-text, and text-to-speech tools.
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 |
|---|---|
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
pip install fastmcp httpx
Using Docker
docker build -t brainiall-mcp .
docker run -e BRAINIALL_API_KEY=your-key -p 8000:8000 brainiall-mcp
Configuration
Set the BRAINIALL_API_KEY environment variable:
export BRAINIALL_API_KEY=your-api-key
Claude 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-mcp
Connect 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 8000
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.
License
MIT
Links
- Brainiall - AI model provider
- Get API Key - Sign up and get your free API key
Tools (4)
assess_pronunciationScore how accurately a speaker pronounced a given text with per-word and phoneme-level feedback.transcribe_speechTranscribe speech audio into text with automatic language detection.synthesize_speechConvert text to natural-sounding speech audio.list_voicesList all available text-to-speech voices.Environment Variables
BRAINIALL_API_KEYrequiredAPI key for accessing Brainiall Speech AI servicesConfiguration
claude_desktop_config.json
{"mcpServers": {"brainiall-speech-ai": {"command": "fastmcp", "args": ["run", "server.py"], "env": {"BRAINIALL_API_KEY": "your-api-key"}}}}Try it
→Assess the pronunciation of the audio file 'recording.mp3' against the text 'The quick brown fox jumps over the lazy dog'.
→Transcribe the speech from the provided audio file and detect the language used.
→Convert the following text into speech using the default voice: 'Welcome to the Brainiall AI demonstration.'
→List all available voices for text-to-speech synthesis.