WebVoice

authSTDIOregistry active

Summary

Wraps the WebVoice REST API for chat completions, text-to-speech, speech-to-text, translation, and image generation from MCP clients like Cursor and Claude Desktop. Ships with agent registration tools that let you sign up via email OTP without leaving the editor, returning an API key and welcome credits. Once registered, you can call webvoice_chat for DeepSeek completions, webvoice_tts to generate MP3 files, webvoice_stt to transcribe local audio, or webvoice_translate for text. Includes credit balance checks and onboarding info with optional Solana wallet details for top-ups. Useful when you want multimodal AI capabilities (voice, translation, image gen) accessible through MCP without managing separate API clients for each provider.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

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.

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

inference shell

create and run specialised agents in minutes

build now →

MCP-ready Email Sending

Plug Mailtrap into your AI workflow and let it handle the email.

Connect Mailtrap MCP →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Capacitor - Shared memory for your team’s coding agents.

Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.

Try For Free →

CodeScene MCP Server

Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.

Try For Free →

Give your AI the whole web as clean markdown

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

Configuration

WEBVOICE_API_KEYsecret

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

WEBVOICE_BASE_URLdefault: https://webvoice.easytaskflow.app/api/v1

REST API base URL

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.

WebVoice

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

Configuration

WebVoice

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

Configuration

Related Communication & Messaging MCP Servers

Related Communication & Messaging MCP Servers