# fasuizu-br/brainiall-mcp-server [Health: Active]

**Category:** 🎧 Text-to-Speech  
**Repository:** https://github.com/fasuizu-br/brainiall-mcp-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 2278576  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/fasuizu-br-brainiall-mcp-server

## Description
AI-powered speech tools: pronunciation assessment with phoneme-level feedback, speech-to-text with language detection, and text-to-speech with multiple voices.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "brainiall-mcp-server": {
    "command": "uvx",
    "args": ["fastmcp"],
    "env": {
      "BRAINIALL_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `BRAINIALL_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What fasuizu-br/brainiall-mcp-server MCP server does

The fasuizu-br/brainiall-mcp-server MCP server connects MCP clients to the Brainiall Speech AI API at `https://api.brainiall.com`. It provides four speech-focused tools: pronunciation scoring, speech transcription, speech synthesis, and voice discovery.

Pronunciation assessment accepts reference text and base64-encoded WAV or MP3 audio. The result includes an overall score from 0 to 100, along with feedback at word and phoneme level. Transcription accepts base64-encoded WAV, MP3, WEBM, or OGG audio and can detect the spoken language automatically. Text synthesis returns MP3 speech, while voice listing returns available voice IDs and supported languages.

## How it works

The MCP server receives tool calls from a compatible client and forwards the relevant request to Brainiall’s Speech AI API. Audio is supplied inline as a base64 string rather than as a file path or upload reference. The API key is read from the `BRAINIALL_API_KEY` environment variable.

`assess_pronunciation` requires the text the speaker was expected to read and the recorded audio. Its optional language value defaults to `en-US`. `transcribe_speech` accepts an optional language hint, while `synthesize_speech` supports a voice ID and a speed multiplier from 0.5 to 2.0. Its default voice is `alloy`, and its default speed is 1.0. `list_voices` does not require parameters.

## Setup and configuration

To use the fasuizu-br/brainiall-mcp-server MCP server, obtain an API key from `app.brainiall.com`, then set `BRAINIALL_API_KEY` in the server process environment. The README documents local execution with FastMCP and a `server.py` entry point. The default local mode uses stdio, which is suitable for clients such as Claude Desktop and Cursor.

The server can also run with Streamable HTTP on port 8000. In that mode, an MCP client connects to `http://localhost:8000/mcp`. Docker usage is documented as an alternative: build the image locally, pass the API key into the container, and publish port 8000.

## Tools and capabilities

- `assess_pronunciation`: Scores spoken audio against supplied reference text and reports word- and phoneme-level feedback.
- `transcribe_speech`: Converts supported audio formats to text and performs automatic language detection.
- `synthesize_speech`: Converts text to MP3 audio using a selected voice and playback speed.
- `list_voices`: Returns the available text-to-speech voices and their supported languages.

## Limitations and notes

The server depends on access to the external Brainiall Speech AI API and cannot operate without a valid `BRAINIALL_API_KEY`. The documented audio inputs must be encoded as base64 before being passed to the tools. Pronunciation assessment accepts WAV and MP3, while transcription additionally supports WEBM and OGG. The README identifies the project as MIT-licensed and does not document usage quotas, latency, billing beyond the availability of a free API key, or offline processing.

_Full upstream README: https://allmcps.com/mcp/fasuizu-br-brainiall-mcp-server/readme_

