Metadata-Version: 2.4
Name: invesvoice-mcp
Version: 1.0.1
Summary: MCP server for InvesVoice — manage AI voice agents from Claude Desktop, Cursor, and other MCP clients.
Project-URL: Homepage, https://voice.inves.dev
Project-URL: Documentation, https://voice.inves.dev/builder/docs/mcp-integration
Author-email: InvesVoice <support@inves.dev>
License-Expression: MIT
Keywords: ai,invesvoice,mcp,voice-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# InvesVoice MCP Server

MCP server for [InvesVoice](https://voice.inves.dev) — manage AI voice agents from Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients.

## Install

```bash
pip install invesvoice-mcp
```

## Setup

### 1. Get a Personal Access Token

Sign in to [InvesVoice](https://voice.inves.dev/builder) → **Dashboard** → **Tokens** → **New Token**.

Copy the token immediately — it won't be shown again.

### 2. Configure your MCP client

#### Claude Desktop

Open **Settings → Developer → Edit Config** and add:

```json
{
  "mcpServers": {
    "invesvoice": {
      "command": "invesvoice-mcp",
      "env": {
        "INVESVOICE_API_URL": "https://voice.inves.dev",
        "INVESVOICE_PAT": "ivpat_your_token_here"
      }
    }
  }
}
```

#### Cursor

Go to **Settings → MCP → Add Server**:

```json
{
  "name": "invesvoice",
  "command": "invesvoice-mcp",
  "env": {
    "INVESVOICE_API_URL": "https://voice.inves.dev",
    "INVESVOICE_PAT": "ivpat_your_token_here"
  }
}
```

### 3. Start using it

Restart your MCP client and try:

- *"List my voice agents"*
- *"Create a customer support agent that speaks Spanish"*
- *"Show me the workflow for agent X"*

## Available Tools

| Category | Tools |
|----------|-------|
| Agents | Create, list, update, delete, publish, unpublish |
| Workflow | Get, save, add/remove nodes, connect nodes, rollback |
| Settings | Update language, LLM/STT/TTS providers, voice behavior |
| Keys | Create, list, revoke API keys |
| Templates | List and clone starter templates |
| Sessions | Create test sessions, check status |
| Analytics | Overview, per-agent stats, usage, quota |
| Embed | Generate embed code for websites |

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `INVESVOICE_API_URL` | Yes | Your InvesVoice server URL |
| `INVESVOICE_PAT` | Yes | Personal Access Token |
| `INVESVOICE_CLIENT` | No | Client name for audit logs |
| `INVESVOICE_MODEL` | No | AI model name for audit logs |

## License

MIT
