Skip to main content
Glama
Sign In
kvc-mcp

kvc-mcp

by KrystalUnity
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

pip install kvc-mcp

Related MCP server: bvoip-mcp

Configure

Create or rotate an API token in the Krystal Voice Caller dashboard, then set:

export KVC_API_TOKEN="kvc_token_..."
export KVC_BASE_URL="https://krystalunity.com/api/admin/kvc"

Cursor example:

{
  "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.

Available Tools

12 tools
kvc_add_dncB

Add an AU E.164 phone number to tenant DNC.

Inputs: phone (required), reason (required). Returns: result

kvc_after_hours_capturesC

Return recent reception captures.

Inputs: limit. Returns: result

kvc_call_historyC

Return recent call outcomes.

Inputs: limit, kind. Returns: result

kvc_chat_script_draftC

Send a message to an active Script Author draft.

Inputs: draft_id (required), message (required). Returns: result

kvc_create_script_draftD

Start a Script Author draft.

Inputs: prompt (required). Returns: result

kvc_get_tenantA

Return current tenant config.

Inputs: no named parameters. Returns: result

kvc_list_dncB

List tenant DNC entries.

Inputs: no named parameters. Returns: result

kvc_list_outbound_capturesC

List captures from outbound Email Hunter calls.

Inputs: limit. Returns: result

kvc_place_test_callC

Place a test outbound roleplay call.

Inputs: target_phone (required). Returns: result

kvc_send_digest_nowB

Trigger an immediate digest email send.

Inputs: no named parameters. Returns: result

kvc_update_tenantC

Patch safe tenant config fields.

Inputs: updates (required). Returns: result

kvc_upload_contactsC

Upload CSV contacts for outbound Email Hunter.

Inputs: csv_content (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.1/5.0

    Scored across 12 tools

    Disambiguation5/5

    All 12 tools have clearly distinct purposes, with no overlap. Related tools like kvc_add_dnc and kvc_list_dnc are for different actions, and kvc_chat_script_draft vs kvc_create_script_draft target different stages of draft management.

    Naming Consistency5/5

    All tool names follow a consistent kvc_verb_noun pattern in snake_case. Verbs are descriptive and nouns are specific, with no mixing of conventions like camelCase.

    Tool Count5/5

    12 tools is well-scoped for a telephony/communication platform. Each tool covers a distinct feature area (DNC, call history, script drafts, tenant config, outbound campaigns, digests) without being overly numerous or sparse.

    Completeness4/5

    The tool set covers core operations like CRUD for DNC (add, list), tenant (get, update), and script drafts (create, send). However, missing delete operations and some campaign management actions (e.g., start/stop) are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers