{
  "markdown": "# WebVoice MCP Server\n\n<!-- mcp-name: io.github.supermarco74/webvoice-mcp -->\n\nLocal [Model Context Protocol](https://modelcontextprotocol.io) server that exposes WebVoice REST API tools to **Cursor**, Claude Desktop, and other MCP clients.\n\n**Install from PyPI:**\n\n```bash\npip install webvoice-mcp\n```\n\n### From source (development)\n\n```bash\npip install -r requirements-mcp.txt\n# or editable install from repo root:\npip install -e .\n```\n\n## Configure Cursor\n\n### Option A — Agent registration via MCP (no browser)\n\n1. Add MCP **without** `WEBVOICE_API_KEY` first (or use the register tools from any client).\n2. Call **`webvoice_register_send_code`** with your email.\n3. Read the OTP from email, then **`webvoice_register_verify`** with the code.\n4. Response includes **`api_key`** (once), **`onboarding.credits`**, **`onboarding.can_use_api`**, and optional **`onboarding.solana`** (wallet + `memo_code` for USDC/SOL top-up).\n5. If `can_use_api` is true, use chat/TTS/STT immediately with welcome credits.\n6. Set `WEBVOICE_API_KEY` in MCP config and restart Cursor (optional Solana/PayPal top-up later).\n\nREST equivalent: `POST /api/v1/auth/send-code/` → `POST /api/v1/auth/verify-code/` with `create_api_key: true`. See [API docs](https://webvoice.easytaskflow.app/api/documentation/#agent-registration).\n\n### Option B — Browser signup (human)\n\n1. **Login** — email OTP or Google (`/accounts/login/`). New users get welcome + daily free credits.\n2. **API key** — [API dashboard](https://webvoice.easytaskflow.app/api/) → Create key → copy `wv_…` (shown once).\n3. **Credits (optional)** — [Buy credits](https://webvoice.easytaskflow.app/billing/purchase/), [Premium](https://webvoice.easytaskflow.app/billing/subscriptions/) (PayPal), or **Solana** (send USDC/SOL with your personal memo from `webvoice_onboarding`).\n\nWhen balance is zero, MCP calls fail with insufficient credits; you receive an email with a recharge link.\n\n### MCP config\n\nEdit Cursor MCP config (`~/.cursor/mcp.json` or **Settings → MCP**):\n\n```json\n{\n  \"mcpServers\": {\n    \"webvoice\": {\n      \"command\": \"webvoice-mcp\",\n      \"env\": {\n        \"WEBVOICE_API_KEY\": \"wv_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nIf `webvoice-mcp` is not on PATH, use Python module form:\n\n```json\n{\n  \"mcpServers\": {\n    \"webvoice\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"webvoice_mcp\"],\n      \"cwd\": \"/path/to/webvoice\",\n      \"env\": {\n        \"WEBVOICE_API_KEY\": \"wv_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nOptional: `WEBVOICE_BASE_URL` (default `https://webvoice.easytaskflow.app/api/v1`).\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `webvoice_register_send_code` | Start registration — OTP to email |\n| `webvoice_register_verify` | Complete registration → API key + onboarding (credits, can_use_api) |\n| `webvoice_onboarding` | Credits, can_use_api, optional Solana wallet/memo, recharge URLs |\n| `webvoice_status` | Credits balance |\n| `webvoice_list_chat_models` | Available chat models |\n| `webvoice_list_voices` | TTS voices |\n| `webvoice_chat` | Chat completions (DeepSeek default) |\n| `webvoice_tts` | Text-to-speech → MP3 |\n| `webvoice_stt` | Transcribe local audio file |\n| `webvoice_translate` | Text translation |\n| `webvoice_image` | MiniMax image generation |\n\n## Example agent flow\n\n**New agent (register → use → optional top-up):**\n\n1. `webvoice_register_send_code` → `webvoice_register_verify` → save `api_key`.\n2. If `onboarding.can_use_api`: call `webvoice_chat` / `webvoice_tts` / … immediately.\n3. Optional: `webvoice_onboarding` → Solana memo or PayPal URLs when you need more credits.\n\n**Existing account:**\n\n1. Ask the model to call `webvoice_chat` with your question.\n2. Call `webvoice_tts` with `output_path` to save spoken reply.\n3. Call `webvoice_stt` with a recorded `audio_path` for voice input.\n\nCredits are billed on your WebVoice account per API call.\n",
  "bytes": 3863,
  "sha": "2c32881eecffa1ebf57121d89ad1235d9ec1e7f179fbd1581f3ddb76cdde130a",
  "repo_slug": "supermarco74/webvoice-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_supermarco74_webvoice_mcp_9c8cee72/readme"
}