Voice Mcp

io.github.forgemeshlabsPublished by GitHub account forgemeshlabsv0.2.7Updated Nov 3, 2026

Give Your Agent A Voice: x402 pay-per-call speech with 20 voices, 10 personas, 31 languages.

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Local MCP server that turns text into WAV speech through a pay-per-call x402 voice API, with 20 voices, 10 personas and 31 languages.

What you can do
  • List the voice catalog: voices, personas, languages, price buckets, character limits and speed/quality ranges
  • Generate standard-voice speech from text in 31 languages
  • Generate speech with granular speed and quality controls
  • Generate expressive persona speech such as Storyteller, Narrator or Urgent
  • Generate speech from an OpenAI-shaped request with input, voice, model and response format
  • Generate batch audio for up to 20 texts in one call
When to use it
Useful when an assistant should speak aloud: narration, status updates, alerts, branded or character voices, demos, and scripted or batched audio sequences. Check the free catalog tool first to pick voices and estimate cost.
Requirements
Runs locally over stdio, installed from the npm package @forgemeshlabs/voice-mcp (Node.js) or via Docker. Needs a Base mainnet wallet private key supplied as WALLET_PRIVATE_KEY holding USDC, since each generation call is paid. Optional X402_MAX_PRICE_USD and X402_SESSION_BUDGET_USD can lower the spending caps. Network access to the fixed backend endpoint.
Before you install
The server signs USDC payments on Base with the private key in WALLET_PRIVATE_KEY, so use a dedicated low-balance wallet. Every generation call costs money (roughly $0.005 to $0.01 per call); the free catalog tool costs nothing. Text you submit is sent to the third-party voice service. Built-in caps limit payee, network, asset and per-call amount, and optional budget variables can only lower them.

Installation

In SourceWeft

  1. Open Voice Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Voice MCP

[M8ven Verified]

[npm version] [npm downloads] [License: MIT] [Node.js] [payments] [network] [mcpservers.org]

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

Tools

ToolPricePurpose
list_voice_catalogFreeVoices, personas, languages, pricing, buckets, and controls
generate_standard_voice$0.005Low-cost speech with 10 standard voices
generate_controlled_voice$0.005 / $0.006Speech with granular speed and quality controls
generate_persona_voice$0.005 / $0.01Storyteller, Velvet, Narrator, Announcer, Assistant, Urgent, and more
generate_openai_compatible_voice$0.005OpenAI-shaped /v1/audio/speech request
generate_batch_voices$0.005Up 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

bash
npm install -g @forgemeshlabs/voice-mcp

Docker

Build:

bash
docker build -t voice-mcp .

Run over stdio:

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

CMD arguments:

json
["node", "index.js"]

MCP Config

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

Requirements and safety

  • Use a dedicated, low-balance wallet; the server signs payments with WALLET_PRIVATE_KEY.
  • The server refuses to sign for any payee other than the ForgeMesh Voice wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the built-in per-call cap ($0.01).
  • Optional env X402_MAX_PRICE_USD (per call) and X402_SESSION_BUDGET_USD (cumulative per process, default $10) can only LOWER the built-in caps.
  • The backend URL is fixed to https://voice.forgemesh.io; all requests are same-origin, time-limited (60s), size-capped (2 MB) and never follow redirects.

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.

Source: README.md at commit a5f423b

Tools

6

list_voice_catalog

List Voice Catalog

Free discovery tool. Lists all 20 voices, 10 persona voices, 31 language codes, price buckets, character limits, and granular speed/quality controls before a paid voice generation call.

Takes no parameters.

generate_standard_voice

Generate Standard Voice

Generate low-cost WAV speech from text using one of 10 standard voices across 31 languages. Best for simple agent narration, status updates, alerts, and short spoken responses. Costs $0.005 for 501-2000 chars.

Parameterslangtextrequiredvoice

generate_controlled_voice

Generate Controlled Voice

Generate WAV speech with granular controls for speed and quality. Use this when an agent needs faster, slower, clearer, more polished, or more deliberate delivery. Costs $0.005 for 1-500 chars or $0.006 for 501-2000 chars.

Parameterslangtextrequiredspeedstepsvoice

generate_persona_voice

Generate Persona Voice

Generate expressive WAV speech with persona voices such as Storyteller, Narrator, Announcer, Assistant, Urgent, Sage, Spark, Anchor, Velvet, or Echo. Best for branded agents, characters, demos, stories, alerts, and premium user experiences. Costs $0.005 for 1-500 chars or $0.01 for 501-2000 chars.

Parameterslangtextrequiredspeedstepsvoice

generate_openai_compatible_voice

Generate OpenAI-Compatible Voice

Generate speech using an OpenAI-shaped request with input, voice, model, and response_format fields. Use this for agents or apps already designed around /v1/audio/speech style payloads. Costs $0.005 for 501-2000 chars.

Parametersinputrequiredmodelvoiceresponse_format

generate_batch_voices

Generate Batch Voices

Generate WAV audio for up to 20 text items in one paid call using standard voices. Best for queues, notifications, scripted sequences, content batches, and multi-step agent workflows. Costs $0.005 for 501-2000 total chars.

Parametersitemsrequireddefaults

Version history

4
  1. v0.2.7LatestNov 3, 2026
  2. v0.2.6Nov 1, 2026
  3. v0.2.5Oct 8, 2026
  4. v0.2.2Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts