How do I install Voice?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Voice need an API key?

No required environment variable is listed on this record.

Voice MCP server

Q: When was Voice last checked?

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

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @forgemeshlabs/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.forgemeshlabs-voice-mcp -- npx -y @forgemeshlabs/voice-mcp@0.2.7

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.forgemeshlabs-voice-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@forgemeshlabs/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.7
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Voice MCP

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

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..."
      }
    }
  }
}

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.

Voice

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Voice?

Does Voice need an API key?

What transport does Voice use?

When was Voice last checked?

Documentation

Voice MCP

Voice Coverage

Voice Samples

Tools

Install

Docker

MCP Config

Requirements and safety

Notes