How do I install Webvoice?

Webvoice is a local plugin. Install it using PyPI package: webvoice-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Webvoice need?

Webvoice requires the following credentials or environment variables: WEBVOICE_API_KEY, WEBVOICE_BASE_URL. You can find setup instructions on the server detail page.

What AI apps work with Webvoice?

Webvoice uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Webvoice MCP Server

by Supermarco74

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

WebVoice MCP: chat, TTS, STT, translate, images. Email signup, welcome credits, optional Solana.

About

WebVoice MCP: chat, TTS, STT, translate, images. Email signup, welcome credits, optional Solana.

Security Report

4.2

Use Caution4.2High Risk

WebVoice MCP server is a well-structured client for a third-party REST API with proper authentication via API keys. The codebase demonstrates good error handling and input validation. Minor code quality concerns around broad exception handling and some input validation edge cases do not rise to the level of security vulnerabilities. Permissions (network_http, env_vars, file_read, file_write) are appropriate for a voice/chat API client that needs to process audio files and cache credentials. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

6 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

WebVoice API key (wv_…). Optional until after webvoice_register_verify; required for chat/TTS/STT.Required

Environment variable: WEBVOICE_API_KEY

REST API base URLOptional

Environment variable: WEBVOICE_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-supermarco74-webvoice-mcp": {
      "env": {
        "WEBVOICE_API_KEY": "your-webvoice-api-key-here",
        "WEBVOICE_BASE_URL": "your-webvoice-base-url-here"
      },
      "args": [
        "webvoice-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

WebVoice MCP Server

Local Model Context Protocol server that exposes WebVoice REST API tools to Cursor, Claude Desktop, and other MCP clients.

Install from PyPI:

pip install webvoice-mcp

From source (development)

pip install -r requirements-mcp.txt
# or editable install from repo root:
pip install -e .

Configure Cursor

Option A — Agent registration via MCP (no browser)

Add MCP without WEBVOICE_API_KEY first (or use the register tools from any client).
Call webvoice_register_send_code with your email.
Read the OTP from email, then webvoice_register_verify with the code.
Response includes api_key (once), onboarding.credits, onboarding.can_use_api, and optional onboarding.solana (wallet + memo_code for USDC/SOL top-up).
If can_use_api is true, use chat/TTS/STT immediately with welcome credits.
Set WEBVOICE_API_KEY in MCP config and restart Cursor (optional Solana/PayPal top-up later).

REST equivalent: POST /api/v1/auth/send-code/ → POST /api/v1/auth/verify-code/ with create_api_key: true. See API docs.

Option B — Browser signup (human)

Login — email OTP or Google (/accounts/login/). New users get welcome + daily free credits.
API key — API dashboard → Create key → copy wv_… (shown once).
Credits (optional) — Buy credits, Premium (PayPal), or Solana (send USDC/SOL with your personal memo from webvoice_onboarding).

When balance is zero, MCP calls fail with insufficient credits; you receive an email with a recharge link.

MCP config

Edit Cursor MCP config (~/.cursor/mcp.json or Settings → MCP):

{
  "mcpServers": {
    "webvoice": {
      "command": "webvoice-mcp",
      "env": {
        "WEBVOICE_API_KEY": "wv_your_key_here"
      }
    }
  }
}

If webvoice-mcp is not on PATH, use Python module form:

{
  "mcpServers": {
    "webvoice": {
      "command": "python",
      "args": ["-m", "webvoice_mcp"],
      "cwd": "/path/to/webvoice",
      "env": {
        "WEBVOICE_API_KEY": "wv_your_key_here"
      }
    }
  }
}

Optional: WEBVOICE_BASE_URL (default https://webvoice.easytaskflow.app/api/v1).

Tools

Tool	Description
`webvoice_register_send_code`	Start registration — OTP to email
`webvoice_register_verify`	Complete registration → API key + onboarding (credits, can_use_api)
`webvoice_onboarding`	Credits, can_use_api, optional Solana wallet/memo, recharge URLs
`webvoice_status`	Credits balance
`webvoice_list_chat_models`	Available chat models
`webvoice_list_voices`	TTS voices
`webvoice_chat`	Chat completions (DeepSeek default)
`webvoice_tts`	Text-to-speech → MP3
`webvoice_stt`	Transcribe local audio file
`webvoice_translate`	Text translation
`webvoice_image`	MiniMax image generation

Example agent flow

New agent (register → use → optional top-up):

webvoice_register_send_code → webvoice_register_verify → save api_key.
If onboarding.can_use_api: call webvoice_chat / webvoice_tts / … immediately.
Optional: webvoice_onboarding → Solana memo or PayPal URLs when you need more credits.

Existing account:

Ask the model to call webvoice_chat with your question.
Call webvoice_tts with output_path to save spoken reply.
Call webvoice_stt with a recorded audio_path for voice input.

Credits are billed on your WebVoice account per API call.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Webvoice MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

What You'll Need

How to Install

Documentation

WebVoice MCP Server

From source (development)

Configure Cursor

Option A — Agent registration via MCP (no browser)

Option B — Browser signup (human)

MCP config

Tools

Example agent flow

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent