forgemeshlabs/voice-mcp

npm version npm downloads License: MIT Node.js payments network

Give Your Agent A Voice: x402 pay-per-call speech with 20 voices, 10 personas, 31 languages, granular speed and quality controls, OpenAI-shaped requests, and batch audio.

This MCP wraps https://voice.forgemesh.io, an x402 Voice API with standard voices, persona voices, OpenAI-shaped speech requests, 31 languages, speed controls, quality controls, and batch generation. Payments are made per call in USDC on Base.

Voice Coverage

• 10 standard voices: M1-M5, F1-F5
• 10 persona voices: Storyteller, Narrator, Announcer, Assistant, Urgent, Sage, Spark, Anchor, Velvet, Echo
• 31 languages: en, ko, ja, ar, bg, cs, da, de, el, es, et, fi, fr, hi, hr, hu, id, it, lt, lv, nl, pl, pt, ro, ru, sk, sl, sv, tr, uk, vi
• Granular control: speed 0.7x-2.0x, quality steps 1-100, persona selection, OpenAI-shaped audio format requests, and batch generation for up to 20 texts
• Voice samples are generated on demand by the paid speech tools and returned as audio_base64 WAV output

Voice Samples

• Assistant sample
• Urgent sample
• Narrator sample
• Storyteller sample

Tools

Tool	Price	Purpose
list_voice_catalog	Free	Voices, personas, languages, pricing, buckets, and controls
generate_standard_voice	$0.001 / $0.003	Low-cost speech with 10 standard voices
generate_controlled_voice	$0.003 / $0.006	Speech with granular speed and quality controls
generate_persona_voice	$0.005 / $0.01	Storyteller, Velvet, Narrator, Announcer, Assistant, Urgent, and more
generate_openai_compatible_voice	$0.001 / $0.003	OpenAI-shaped /v1/audio/speech request
generate_batch_voices	$0.002 / $0.005	Up to 20 texts per call

Short prices apply to 1-500 characters. Long prices apply to 501-2000 characters.

The MCP validates voice names, language codes, audio formats, speed/quality ranges, batch item count, and character limits locally before making a paid x402 call.

Install

npm install -g @forgemeshlabs/voice-mcp

Docker

Build:

docker build -t voice-mcp .

Run over stdio:

docker run --rm -i \
  -e WALLET_PRIVATE_KEY=0x... \
  voice-mcp

CMD arguments:

["node", "index.js"]

MCP Config

{
  "mcpServers": {
    "voice": {
      "command": "voice-mcp",
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Optional:

{
  "X402_VOICE_BASE_URL": "https://voice.forgemesh.io",
  "BASE_RPC_URL": "https://mainnet.base.org"
}

Notes

• Paid tools require a Base wallet private key with USDC.
• The server returns audio_base64 for audio tools so MCP clients can store, play, or forward the WAV bytes.
• No API keys or subscriptions are required for the voice service itself.