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_KEYfirst (or use the register tools from any client). - Call
webvoice_register_send_codewith your email. - Read the OTP from email, then
webvoice_register_verifywith the code. - Response includes
api_key(once),onboarding.credits,onboarding.can_use_api, and optionalonboarding.solana(wallet +memo_codefor USDC/SOL top-up). - If
can_use_apiis true, use chat/TTS/STT immediately with welcome credits. - Set
WEBVOICE_API_KEYin 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→ saveapi_key.- If
onboarding.can_use_api: callwebvoice_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_chatwith your question. - Call
webvoice_ttswithoutput_pathto save spoken reply. - Call
webvoice_sttwith a recordedaudio_pathfor voice input.
Credits are billed on your WebVoice account per API call.
Metadata
Release files for webvoice-mcp 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| webvoice_mcp-0.2.1.tar.gz | 21.7 kB | Without provenance | Details for webvoice_mcp-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| webvoice_mcp-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for webvoice_mcp-0.2.1-py3-none-any.whl |
Total release size: 33.7 kB
Release files / webvoice_mcp-0.2.1.tar.gz
| Download URL | webvoice_mcp-0.2.1.tar.gz |
|---|---|
| Size | 21.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6667f25af71f908449eed42fd9946beea3c91ebb98d24d58fdffa85a6d5cfc23
|
|
BLAKE2b-256 checksum How to use checksums |
f33542d7e0ff8bb12c591c7e7ea374b1eb9d7865c8629fda463188316bca70a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|
Release files / webvoice_mcp-0.2.1-py3-none-any.whl
| Download URL | webvoice_mcp-0.2.1-py3-none-any.whl |
|---|---|
| Size | 12.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ccfba169d3d54a56a89bb5e3f1a691bcc40c3889ea53b1eecf5faf28a5e7db55
|
|
BLAKE2b-256 checksum How to use checksums |
c241106405a70c98906cf7b6e65832b42543423c783aec2054a72ebef875487d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|
Security for webvoice-mcp 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.