Log inSubmit server
Voice MCP logo

Voice MCP

by forgemeshlabs

Paid x402 speech generation over MCP with multilingual voices, personas, controls, OpenAI-shaped requests, and batch WAV output.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Voice MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "forgemeshlabs-voice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/voice-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The forgemeshlabs/voice-mcp MCP server exposes multilingual text-to-speech tools backed by the ForgeMesh Voice API. It supports standard and persona voices, speed and quality settings, OpenAI-shaped speech requests, and batches of up to 20 text items. Paid requests use x402 payments in USDC on Base and return WAV audio as base64 data. Reach for it when an agent needs spoken responses, alerts, narration, voice samples, or scripted audio without using a separate subscription-based voice API.

Use cases

  • Generate spoken agent status updates
  • Create multilingual alerts and notifications
  • Produce persona-based narration for stories and demos
  • Batch scripted audio for queues and workflows
  • Adapt OpenAI-shaped speech requests

Key features

  • 20 voices and 10 persona voices
  • 31 language codes
  • Speed and quality controls
  • OpenAI-shaped speech requests
  • Batch generation for up to 20 texts
  • Base x402 USDC payments

Tools6

What Voice MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

17/17 checks healthy over the last 83d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · @forgemeshlabs/voice-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Voice MCP works

What forgemeshlabs/voice-mcp MCP server does

The forgemeshlabs/voice-mcp MCP server gives an MCP client access to speech generation through https://voice.forgemesh.io. It can turn text into WAV audio using 10 standard voices, 10 persona voices, and 31 supported language codes. Generated audio is returned as audio_base64, allowing the calling client or application to store, play, or forward the WAV bytes.

A free catalog tool exposes the available voices, persona names, languages, pricing buckets, character limits, and supported controls before an agent makes a paid request. The paid tools cover low-cost standard speech, controlled speech with speed and quality settings, expressive persona speech, OpenAI-shaped requests, and batch generation.

How it works

The forgemeshlabs/voice-mcp MCP server validates request values locally before sending a paid x402 call. Validation includes voice names, language codes, audio formats, speed and quality ranges, batch size, and text length. The available speed range is 0.7x to 2.0x, while quality uses steps from 1 through 100.

Payments are made per call in USDC on Base. The server requires access to a Base wallet through its private key for paid tools. No voice-service API key or subscription is required. Standard and OpenAI-compatible generation cost $0.001 for 1–500 characters and $0.003 for 501–2,000 characters. Controlled generation costs $0.003 or $0.006 for those same length bands; persona generation costs $0.005 or $0.01; batch generation costs $0.002 or $0.005 based on total characters.

Setup and configuration

Install the npm package globally with:

Terminal
npm install -g @forgemeshlabs/voice-mcp

A stdio MCP configuration can start the installed voice-mcp command and provide WALLET_PRIVATE_KEY in its environment. The key must belong to a Base wallet funded with USDC if paid tools will be used. Docker is also supported: build the repository image with the supplied Dockerfile and run it interactively with the wallet key passed as an environment variable.

Two optional settings are documented. X402_VOICE_BASE_URL changes the voice API base URL, and BASE_RPC_URL changes the Base RPC endpoint. The documented defaults are https://voice.forgemesh.io and https://mainnet.base.org respectively.

Tools and capabilities

  • list_voice_catalog provides free capability and pricing discovery.
  • generate_standard_voice creates speech with the 10 standard voices.
  • generate_controlled_voice adds speed and quality controls.
  • generate_persona_voice selects personas such as Storyteller, Narrator, Assistant, Urgent, Sage, or Echo.
  • generate_openai_compatible_voice accepts an OpenAI-shaped request with input, voice, model, and response_format fields.
  • generate_batch_voices processes up to 20 text items in one call using standard voices.

The forgemeshlabs/voice-mcp MCP server is suitable for agent narration, status messages, alerts, branded or character dialogue, scripted sequences, queues, and applications already structured around /v1/audio/speech-style payloads.

Limitations and notes

The catalog lookup is free, but speech generation is paid. Text length and batch limits apply, with the documented maximum of 2,000 characters for the supported single-text price bands and up to 20 items per batch. Audio tools return WAV data encoded in base64 rather than an audio file path or hosted download URL. A Base wallet private key and sufficient USDC are therefore needed for production use of paid capabilities.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Voice MCP

Install the npm package globally with `npm install -g @forgemeshlabs/voice-mcp`, then configure the `voice-mcp` stdio command for your MCP client.

No API key or subscription is required for the voice service. Paid tools require a Base wallet private key with USDC.

Paid calls use x402 payments in USDC on Base. Prices vary by tool and text length.

The speech tools return WAV audio as an `audio_base64` value.

Related MCP servers

All in Text-to-Speech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVoice MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/forgemeshlabs-voice-mcp?style=directory)](https://allmcps.com/mcp/forgemeshlabs-voice-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/forgemeshlabs-voice-mcp"><img src="https://allmcps.com/api/badge/forgemeshlabs-voice-mcp?style=directory" alt="Voice MCP on AllMCPs" /></a>