Text to speech API for your appFree plan

claude mcp add --transport http voicehue https://voicehue.com/mcp \
  --header "Authorization: Bearer $VOICEHUE_API_KEY"

{
  "mcpServers": {
    "voicehue": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://voicehue.com/mcp", "--header", "Authorization:${VOICEHUE_AUTH}"],
      "env": {"VOICEHUE_AUTH": "Bearer vh_live_YOUR_KEY"}
    }
  }
}

{
  "mcpServers": {
    "voicehue": {
      "url": "https://voicehue.com/mcp",
      "headers": {"Authorization": "Bearer ${env:VOICEHUE_API_KEY}"}
    }
  }
}

codex mcp add voicehue --url https://voicehue.com/mcp --bearer-token-env-var VOICEHUE_API_KEY

{
  "inputs": [{"type": "promptString", "id": "voicehue-key", "description": "VoiceHue API key", "password": true}],
  "servers": {
    "voicehue": {
      "type": "http",
      "url": "https://voicehue.com/mcp",
      "headers": {"Authorization": "Bearer ${input:voicehue-key}"}
    }
  }
}

{
  "mcpServers": {
    "voicehue": {
      "serverUrl": "https://voicehue.com/mcp",
      "headers": {"Authorization": "Bearer ${env:VOICEHUE_API_KEY}"}
    }
  }
}

{
  "mcpServers": {
    "voicehue": {
      "httpUrl": "https://voicehue.com/mcp",
      "headers": {"Authorization": "Bearer $VOICEHUE_API_KEY"}
    }
  }
}

from openai import OpenAI

client = OpenAI(base_url="https://voicehue.com/v1", api_key="YOUR_API_KEY")

with client.audio.speech.with_streaming_response.create(
    model="voicehue-tts",
    voice="vh-es-alex",
    input="Hello from VoiceHue.",
) as response:
    response.stream_to_file("hello.mp3")

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({baseURL: "https://voicehue.com/v1", apiKey: process.env.VOICEHUE_API_KEY});

const audio = await client.audio.speech.create({
  model: "voicehue-tts",
  voice: "vh-es-alex",
  input: "Hello from VoiceHue.",
});
fs.writeFileSync("hello.mp3", Buffer.from(await audio.arrayBuffer()));

import os
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "voicehue": {
        "transport": "streamable_http",
        "url": "https://voicehue.com/mcp",
        "headers": {"Authorization": "Bearer " + os.environ["VOICEHUE_API_KEY"]},
    }
})
tools = await client.get_tools()  # text_to_speech, list_voices

import os
from openai import OpenAI
from langchain_core.tools import tool

client = OpenAI(base_url="https://voicehue.com/v1", api_key=os.environ["VOICEHUE_API_KEY"])

@tool
def speak(text: str, voice: str = "VOICE_ID") -> str:
    """Convert text to speech with VoiceHue and save it as speech.mp3."""
    with client.audio.speech.with_streaming_response.create(
        model="voicehue-tts", voice=voice, input=text
    ) as response:
        response.stream_to_file("speech.mp3")
    return "speech.mp3"

Method:          POST
URL:             https://voicehue.com/v1/audio/speech
Authentication:  Header Auth
  Name:          Authorization
  Value:         Bearer vh_live_YOUR_KEY
Body (JSON):     {"model": "voicehue-tts", "input": "{{your text}}", "voice": "VOICE_ID"}
Response:        File / binary (the audio is the response body, MP3 by default)

# 1. handshake (no key needed)
curl -s https://voicehue.com/mcp -H "Authorization: Bearer $VOICEHUE_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# 2. list the tools
curl -s https://voicehue.com/mcp -H "Authorization: Bearer $VOICEHUE_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. speak (the audio comes back base64 in result.content)
curl -s https://voicehue.com/mcp -H "Authorization: Bearer $VOICEHUE_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"text_to_speech","arguments":{"text":"Hello from VoiceHue.","voice":"VOICE_ID"}}}'