Brainiall TTS MCP
Servidor MCP de texto-para-fala hospedado com 54 vozes neurais em 9 idiomas, incluindo português brasileiro, usando autenticação por chave de API e cobrança por uso.
Documentação
Servidor Brainiall TTS MCP
Texto-para-fala hospedado para agentes de IA via Model Context Protocol.
54 vozes neurais, 9 idiomas — incluindo Português Brasileiro nativo (pf_dora, pm_alex, pm_santa) — servidos por uma API hospedada, com pagamento por uso. Sem GPU, sem downloads de modelos, sem assinatura ElevenLabs: traga uma chave de API e pague $0,008 por 1.000 caracteres ($10 de créditos grátis no cadastro).
Por que este servidor
Todos os outros servidores MCP de TTS ou executam modelos localmente (pesados, lentos de configurar) ou encapsulam uma chave de terceiros pela qual você já paga assinatura. Este é uma API hospedada e medida:
- Zero configuração — servidor remoto, nada para instalar
- Pague por uso — $0,008/1K caracteres, cobrado do seu saldo Brainiall
- $10 de créditos grátis — cadastre-se em app.brainiall.com
- Saída WAV — PCM de 16 bits, 24 kHz mono, retornado como conteúdo de áudio MCP reproduzível ou JSON base64
Início rápido
Obtenha uma chave de API em app.brainiall.com ($10 de créditos de boas-vindas, sem cartão necessário).
VS Code / GitHub Copilot
O botão instala o servidor remoto em modo de descoberta, para que o VS Code possa listar suas ferramentas sem um segredo. A síntese ainda falha de forma segura até você adicionar sua chave de API Brainiall. Para uma configuração segura de workspace que solicita uma vez e armazena a chave no armazenamento de segredos do VS Code, copie .vscode/mcp.json para seu projeto ou clone este repositório, depois inicie brainiallTts a partir de MCP: Listar Servidores.
{
"inputs": [
{
"type": "promptString",
"id": "brainiall-api-key",
"description": "Brainiall API key",
"password": true
}
],
"servers": {
"brainiallTts": {
"type": "http",
"url": "https://api.brainiall.com/mcp/tts/mcp",
"headers": {
"Authorization": "Bearer ${input:brainiall-api-key}"
}
}
}
}
Após o servidor iniciar, tente:
Use Brainiall TTS para listar as vozes em português brasileiro e depois leia "Olá do VS Code" com
pf_dora.
O formato da URL de instalação e a configuração de entrada de segredo seguem o guia oficial de MCP do VS Code e a referência de configuração.
Agente de nuvem GitHub Copilot
Use a configuração de servidor remoto restrita para o agente de nuvem Copilot ou revisão de código Copilot. Ela permite as três ferramentas Brainiall e resolve o token Bearer a partir do segredo COPILOT_MCP_BRAINIALL_API_KEY Agents do repositório; nenhuma chave de API é commitada.
Continue (VS Code / JetBrains)
Copie o bloco MCP do Continue pronto para uso
para .continue/mcpServers/brainiall-tts.yaml, depois coloque
BRAINIALL_API_KEY=your-key em .continue/.env. Mantenha esse arquivo .env fora
do controle de versão.
O bloco usa o transporte streamable-http suportado pelo Continue e resolve
a chave por meio de ${{ secrets.BRAINIALL_API_KEY }}; nenhuma credencial é commitada.
Veja a configuração e teste de fumaça do Continue.
Construtores Dify
Para um fluxo de trabalho de fala Dify, use o provedor BRAINIALL Speech de código aberto e mantenha a chave de API no armazenamento de credenciais do Dify. A rota de intenção Dify limitada explica o limite de propriedade do chamador; não é uma parceria Dify nem uma garantia de comportamento em produção.
Servidor remoto (recomendado — nada para instalar)
Codex CLI / IDE / aplicativo de desktop ChatGPT
Use a configuração Codex com escopo de projeto. Ela lê
BRAINIALL_API_KEY do ambiente, permite as três ferramentas Brainiall
e solicita confirmação antes de cada chamada.
Claude Code
Use a configuração Claude Code com suporte a ambiente. Ela mantém a chave fora de .mcp.json, limita o servidor ao projeto atual e documenta o limite de dados externos e uso medido.
Claude Desktop / qualquer cliente com configuração estilo .mcp.json
{
"mcpServers": {
"brainiall-tts": {
"type": "http",
"url": "https://api.brainiall.com/mcp/tts/mcp",
"headers": {
"Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
}
}
}
}
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"brainiall-tts": {
"url": "https://api.brainiall.com/mcp/tts/mcp",
"headers": {
"Authorization": "Bearer YOUR_BRAINIALL_API_KEY"
}
}
}
}
LM Studio
Use o deeplink oficial de um clique e o limite explícito de privacidade do modelo local no guia de configuração do LM Studio.
OpenCode v2
Use o esquema de servidor remoto e o cabeçalho Bearer com suporte a ambiente no guia de configuração do OpenCode v2.
Msty Studio
Use o guia de campo manual do Msty Studio para uma conexão HTTP Streamable. O arquivo de referência não é apresentado como uma integração oficial ou predefinição de importação.
Interface de Chat Hugging Face (auto-hospedada)
Use o exemplo de MCP_SERVERS para administradores
e um modelo com capacidade de ferramentas. O guia documenta o limite de chave compartilhada para servidores
base.
Clientes que exigem /v1/audio/speech
Use o adaptador TTS parcial com formato OpenAI de zero dependência quando um cliente puder configurar uma rota de fala estilo OpenAI, mas não puder chamar o endpoint nativo da Brainiall. O adaptador retorna apenas WAV, declara a taxa de amostragem observada no cabeçalho WAV, nunca tenta novamente uma solicitação medida e documenta os limites exatos de compatibilidade. É um adaptador de referência local, não uma afirmação de que a API Brainiall hospedada é nativamente compatível com OpenAI.
Executar localmente (sem stdio, ainda chama a API hospedada)
O servidor em si é um wrapper fino — você pode auto-hospedá-lo e ele fará proxy para api.brainiall.com com sua chave:
docker build -t brainiall-tts-mcp .
docker run -p 8080:8080 -e APIM_KEY=YOUR_BRAINIALL_API_KEY brainiall-tts-mcp
# MCP endpoint: http://localhost:8080/mcp
Ferramentas
| Ferramenta | Descrição | Custo |
|---|---|---|
synthesize_speech | Converte texto (≤5000 caracteres) em fala WAV. Parâmetros: text, language (padrão pt), voice, speed (0,5–2,0), output_format (audio | base64_json) | $0,008/1K caracteres |
list_voices | Catálogo completo de vozes com idioma, gênero, sotaque, grau de qualidade. Filtro opcional language | grátis |
check_tts_service | Status de saúde do backend | grátis |
Vozes
| Idioma | Vozes |
|---|---|
| Português (BR) | pf_dora, pm_alex, pm_santa |
| Inglês (EUA) | af_heart, af_bella, af_nova, am_adam, am_michael + 14 mais |
| Inglês (GB) | bf_alice, bf_emma, bm_daniel, bm_george + 4 mais |
| Espanhol | ef_dora, em_alex, em_santa |
| Francês | ff_siwis, fm_gilles |
| Italiano | if_sara, im_nicola |
| Hindi | hf_alpha, hf_beta, hm_omega, hm_psi |
| Japonês | jf_alpha, jf_gongitsune, jm_kumo + 2 mais |
| Mandarim | zf_xiaoxiao, zm_yunxi + 6 mais |
Exemplo
Pergunte ao seu agente:
"Leia este parágrafo em voz alta em português brasileiro com uma voz feminina"
O agente chama synthesize_speech(text=..., language="pt", voice="pf_dora") e recebe áudio WAV reproduzível.
Para prompts prontos para copiar e testes de fumaça para narração, acessibilidade, prática de idiomas e alertas de agente, veja Receitas de fluxo de trabalho para agentes.
Para testes e automação com clientes REST, importe a coleção Postman. Ela contém testes de fumaça de saúde, lista de vozes e síntese de dois caracteres e mantém a chave de API em uma variável de coleção em vez da URL da solicitação.
Para automação sem código, importe o fluxo de trabalho n8n de texto para WAV. Ele usa a credencial de Autenticação de Cabeçalho do n8n em vez de incorporar uma chave no fluxo de trabalho, envia campos editáveis de texto, voz e velocidade para a API hospedada e retorna o WAV na propriedade binária speech. O modelo é validado estaticamente; selecione sua credencial e execute-o em sua própria instância n8n para validar a integração ao vivo.
Para geração de código, clientes de API e descoberta de diretórios, use a especificação OpenAPI 3.1 legível por máquina. A especificação documenta o catálogo de vozes autenticado e os endpoints de síntese WAV sem incorporar uma chave de API.
Autenticação e cobrança
Passe sua chave de API Brainiall como um token Bearer (veja as configurações acima). O uso é medido por caractere contra o saldo da sua conta — a mesma chave funciona em todas as APIs Brainiall (STT, OCR, NLP, imagem e mais em brainiall.com).
Endpoints
- MCP (HTTP Streamable):
https://api.brainiall.com/mcp/tts/mcp - Saúde:
https://api.brainiall.com/mcp/tts/health - API REST subjacente:
POST https://api.brainiall.com/v1/tts/synthesize
Licença
MIT