{
  "markdown": "# Voice MCP\n\n[![M8ven Verified](https://m8ven.ai/badge/mcp/forgemeshlabs-voice-mcp-q8gh7d?variant=verified)](https://m8ven.ai/mcp/forgemeshlabs-voice-mcp-q8gh7d)\n\n[![npm version](https://img.shields.io/npm/v/@forgemeshlabs/voice-mcp)](https://www.npmjs.com/package/@forgemeshlabs/voice-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@forgemeshlabs/voice-mcp)](https://www.npmjs.com/package/@forgemeshlabs/voice-mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n[![payments](https://img.shields.io/badge/payments-x402%20USDC-0052FF)](https://x402.org)\n[![network](https://img.shields.io/badge/network-Base-0052FF)](https://base.org)\n\nGive 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.\n\nThis 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.\n\n## Voice Coverage\n\n- 10 standard voices: `M1`-`M5`, `F1`-`F5`\n- 10 persona voices: `Storyteller`, `Narrator`, `Announcer`, `Assistant`, `Urgent`, `Sage`, `Spark`, `Anchor`, `Velvet`, `Echo`\n- 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`\n- 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\n- Voice samples are generated on demand by the paid speech tools and returned as `audio_base64` WAV output\n\n## Voice Samples\n\n- [Assistant sample](https://voice.forgemesh.io/samples/_expressive/combo_assistant.wav)\n- [Urgent sample](https://voice.forgemesh.io/samples/_expressive/combo_urgent.wav)\n- [Narrator sample](https://voice.forgemesh.io/samples/_expressive/combo_narrator.wav)\n- [Storyteller sample](https://voice.forgemesh.io/samples/_expressive/combo_storyteller.wav)\n\n## Tools\n\n| Tool | Price | Purpose |\n|------|-------|---------|\n| `list_voice_catalog` | Free | Voices, personas, languages, pricing, buckets, and controls |\n| `generate_standard_voice` | $0.001 / $0.003 | Low-cost speech with 10 standard voices |\n| `generate_controlled_voice` | $0.003 / $0.006 | Speech with granular speed and quality controls |\n| `generate_persona_voice` | $0.005 / $0.01 | Storyteller, Velvet, Narrator, Announcer, Assistant, Urgent, and more |\n| `generate_openai_compatible_voice` | $0.001 / $0.003 | OpenAI-shaped `/v1/audio/speech` request |\n| `generate_batch_voices` | $0.002 / $0.005 | Up to 20 texts per call |\n\nShort prices apply to 1-500 characters. Long prices apply to 501-2000 characters.\n\nThe MCP validates voice names, language codes, audio formats, speed/quality ranges,\nbatch item count, and character limits locally before making a paid x402 call.\n\n## Install\n\n```bash\nnpm install -g @forgemeshlabs/voice-mcp\n```\n\n## Docker\n\nBuild:\n\n```bash\ndocker build -t voice-mcp .\n```\n\nRun over stdio:\n\n```bash\ndocker run --rm -i \\\n  -e WALLET_PRIVATE_KEY=0x... \\\n  voice-mcp\n```\n\nCMD arguments:\n\n```json\n[\"node\", \"index.js\"]\n```\n\n## MCP Config\n\n```json\n{\n  \"mcpServers\": {\n    \"voice\": {\n      \"command\": \"voice-mcp\",\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\nOptional:\n\n```json\n{\n  \"X402_VOICE_BASE_URL\": \"https://voice.forgemesh.io\",\n  \"BASE_RPC_URL\": \"https://mainnet.base.org\"\n}\n```\n\n## Notes\n\n- Paid tools require a Base wallet private key with USDC.\n- The server returns `audio_base64` for audio tools so MCP clients can store, play, or forward the WAV bytes.\n- No API keys or subscriptions are required for the voice service itself.\n",
  "bytes": 3910,
  "sha": "d9fea418233e10eec23615a27a4a235fb904b5cc7e910c046b27e2ebcd37523c",
  "repo_slug": "forgemeshlabs/voice-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_forgemeshlabs_voice_mcp_429db53c/readme"
}