fasuizu-br/brainiall-mcp-server
speech with multiple voices.
Ask AI about fasuizu-br/brainiall-mcp-server
Powered by Claude · Grounded in docs
I know everything about fasuizu-br/brainiall-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
