Brainiall MCP Server README

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

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

transcribe_speech

synthesize_speech

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