Content
# kvc-mcp
MCP access is included with every Krystal Voice Caller tier. Use this package to manage a tenant from Claude, Cursor, or any MCP-aware agent.
mcp-name: io.github.KrystalUnity/kvc-mcp
## Install
```bash
pip install kvc-mcp
```
## Configure
Create or rotate an API token in the Krystal Voice Caller dashboard, then set:
```bash
export KVC_API_TOKEN="kvc_token_..."
export KVC_BASE_URL="https://krystalunity.com/api/admin/kvc"
```
Cursor example:
```json
{
"mcpServers": {
"krystal-voice-caller": {
"command": "kvc-mcp",
"env": {
"KVC_API_TOKEN": "kvc_token_..."
}
}
}
}
```
## Tools
The server exposes tenant config, DNC, call history, reception captures, digest send-now, Script Author draft chat, contact upload, outbound captures, and test-call tools. Product availability is enforced by the Krystal Voice Caller API, so Reception-only tenants get inbound/reception tools and Bundle/Premium tenants get outbound Email Hunter tools.
Script approval is not exposed through MCP. Approval stays admin-only in the web UI.
## Publish
Operator-only steps:
1. `cd packages/kvc-mcp && uv build`
2. `uv publish --username __token__ --password "$PYPI_TOKEN"`
3. Submit an MCP Registry entry named `io.github.KrystalUnity/kvc-mcp` pointing at the PyPI package.
4. Verify from a fresh venv with `pip install kvc-mcp && kvc-mcp --help`.
