Movoice

npm version License: MIT MCP

Create and manage voice AI agents directly from Claude Desktop or Cursor using natural language — no dashboard required.

"Create a customer support agent for my e-commerce store. Use a friendly female voice and make it handle order status and returns."

That's it. The agent is live and ready to take calls.

---

What you can do

• Create a voice AI agent by describing it in plain English
• List all your agents
• Update agent prompts, voices, or settings
• Delete agents
• View call logs and transcripts

---

Quickstart

Option 1 — npx (no install needed)

{
  "mcpServers": {
    "movoice": {
      "command": "npx",
      "args": ["-y", "@movoice/mcp"],
      "env": {
        "MOVOICE_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

Option 2 — Install globally

npm install -g @movoice/mcp

{
  "mcpServers": {
    "movoice": {
      "command": "movoice-mcp",
      "env": {
        "MOVOICE_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

---

Setup

Step 1 — Get your API key

Go to app.movoice.ai/admin/account → API Keys → Generate Key

Your key looks like: mv_live_xxxxxxxxxxxxxxxx

Step 2 — Add to your client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "movoice": {
      "command": "npx",
      "args": ["-y", "@movoice/mcp"],
      "env": {
        "MOVOICE_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop.

Cursor

Go to Cursor Settings → MCP → Add Server:

{
  "movoice": {
    "command": "npx",
    "args": ["-y", "@movoice/mcp"],
    "env": {
      "MOVOICE_API_KEY": "mv_live_your_key_here"
    }
  }
}

VS Code (with MCP extension)

Add to .vscode/mcp.json:

{
  "servers": {
    "movoice": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@movoice/mcp"],
      "env": {
        "MOVOICE_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

---

Example prompts

Once connected, just talk naturally:

"Create a customer support agent for my e-commerce store called ShopBot. It should handle order status, returns, and general questions. Use a friendly female voice."

"Show me all my agents"

"Update the ShopBot's welcome message to say 'Hi! I'm ShopBot, your shopping assistant. How can I help?'"

"Create a sales agent for an insurance company that qualifies leads and books appointments. Make it speak Hindi."

"Show me the last 10 calls and summarise what customers were asking about"

"Delete the test agent"

---

Available tools

Tool	Description
list_agents	List all your voice agents
create_agent	Create a new voice agent
get_agent	Get details of a specific agent
update_agent	Update agent settings
delete_agent	Delete an agent
list_calls	View recent call logs
get_call	Get full call details + transcript

create_agent parameters

Parameter	Type	Required	Description
name	string	✅	Agent name (e.g. "Sales Bot")
prompt	string	✅	System prompt — personality, knowledge, behavior
welcomeMessage	string	✅	First thing the agent says when a call connects
llmProvider	string		openai / anthropic / groq (default: openai)
llmModel	string		e.g. gpt-4o-mini, claude-opus-4-6 (default: gpt-4o-mini)
ttsProvider	string		elevenlabs / openai / deepgram / sarvam
ttsVoice	string		Voice ID or name (default: rachel)
asrProvider	string		deepgram / sarvam (default: deepgram)
language	string		Language code e.g. en-US, hi-IN (default: en-US)
webhookUrl	string		Webhook URL to receive call events

---

Environment variables

Variable	Required	Description
MOVOICE_API_KEY	✅	Your Movoice API key (mv_live_...)
MOVOICE_API_URL		Override API base URL (default: https://app.movoice.ai)

---

Build from source

git clone https://github.com/Movoiceai/movoice-mcp.git
cd movoice-mcp
npm install
npm run build

Then point your MCP client to dist/index.js:

{
  "mcpServers": {
    "movoice": {
      "command": "node",
      "args": ["/path/to/movoice-mcp/dist/index.js"],
      "env": {
        "MOVOICE_API_KEY": "mv_live_your_key_here"
      }
    }
  }
}

---

Links

• Movoice AI — Dashboard
• Documentation — Full API docs
• Issues — Report a bug
• MCP Protocol — Learn about MCP

---

License

MIT © Movoice AI