Skip to main content
Glama
kolivri-voice-mcp

kolivri-voice-mcp

Official
by kolivritech

kolivri-voice-mcp — Real AI Phone Line for Claude Code, OpenCode, Cursor & Claude Desktop

kolivritech/kolivri-voice-mcp MCP server

kolivri-voice-mcp is a zero-dependency Node.js ESM Model Context Protocol (MCP) server that gives AI coding and operator agents a real phone line powered by Kolivri (app.kolivri.co.il).

Live 24/7 AI Demo Lines & Contact

  • US 24/7 Live AI Phone Line: +1 (507) 604-6732

  • Israel 24/7 Live AI Phone Line: 074-760-5550 (+972-74-760-5550)

  • Support & Partnerships: stas@kolivri.com · WhatsApp 054-787-5670

  • Web & Onboarding: kolivri.com · app.kolivri.co.il

Related MCP server: Arara MCP

Features & Tools

  1. kolivri_place_call — Trigger an outbound AI voice call via POST ${KOLIVRI_API_URL}/api/v1/engine/trigger/${webhookId}:

    • Normalizes Israeli (054-1234567) and international E.164 (+972541234567) phone numbers.

    • Enforces language whitelist (he, en, ar, ru, fr, es, de, pt, default he).

    • Enforces KYC verified-caller checks (verifiedCallerId + optional KOLIVRI_VERIFIED_CALLER_ID allowlist).

    • Enforces per-key sliding-window rate limits (KOLIVRI_MAX_CALLS_PER_MINUTE, default 5/min) to prevent robocall loops.

  2. kolivri_get_call_status — Fetch call status, structured outcome, transcript, summary, appointment status, and recording URL.

  3. kolivri_carrier_forwarding_codes — Generate exact 30-second GSM/IMS call-forwarding dial strings (*61*, *67*, *62*, *004*, *21*, and ##002# reset) for Israeli carriers (partner, pelephone, cellcom, hot_mobile, golan, 019, we4g, bezeq).

  4. kolivri_preview_roi — Compute monthly SMB missed-call loss, recovered revenue, and recommend the matching Kolivri unified plan (Starter $69 / ₪247, Business $139 / ₪479, Pro $249 / ₪880).

Environment Variables

Variable

Required

Default

Description

KOLIVRI_API_KEY

Yes (for live calls)

—

Kolivri API key sent in x-api-key header

KOLIVRI_WEBHOOK_ID

Optional

default-webhook

Default Kolivri campaign/engine webhook ID

KOLIVRI_VERIFIED_CALLER_ID

Optional

—

Comma-separated KYC-verified caller IDs in E.164 or Israeli format

KOLIVRI_API_URL

Optional

https://app.kolivri.co.il

Kolivri API base URL

KOLIVRI_MAX_CALLS_PER_MINUTE

Optional

5

Maximum outbound calls per minute per API key

Installation

1. Claude Code (claude mcp add)

claude mcp add kolivri-voice \
  -e KOLIVRI_API_KEY="your-kolivri-api-key" \
  -e KOLIVRI_WEBHOOK_ID="your-webhook-id" \
  -e KOLIVRI_VERIFIED_CALLER_ID="+97235550199" \
  -- node /path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs

2. OpenCode (~/.config/opencode/opencode.json)

Add kolivri-voice under the "mcp" key in opencode.json:

{
  "mcp": {
    "kolivri-voice": {
      "type": "local",
      "command": ["node", "/path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs"],
      "environment": {
        "KOLIVRI_API_KEY": "your-kolivri-api-key",
        "KOLIVRI_WEBHOOK_ID": "your-webhook-id",
        "KOLIVRI_VERIFIED_CALLER_ID": "+97235550199"
      },
      "enabled": true
    }
  }
}

3. Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kolivri-voice": {
      "command": "node",
      "args": ["/path/to/kolivri-code/kolivri-voice-mcp/src/server.mjs"],
      "env": {
        "KOLIVRI_API_KEY": "your-kolivri-api-key",
        "KOLIVRI_WEBHOOK_ID": "your-webhook-id",
        "KOLIVRI_VERIFIED_CALLER_ID": "+97235550199"
      }
    }
  }
}

4. Docker

docker build -t kolivri-voice-mcp .
docker run -i --rm \
  -e KOLIVRI_API_KEY="your-kolivri-api-key" \
  -e KOLIVRI_WEBHOOK_ID="your-webhook-id" \
  -e KOLIVRI_VERIFIED_CALLER_ID="+97235550199" \
  kolivri-voice-mcp

Running Tests

node --test kolivri-voice-mcp/test/voice-mcp.test.mjs

Available Tools

4 tools
kolivri_carrier_forwarding_codesA
Read-onlyIdempotent

Generate 30-second GSM/carrier call-forwarding dial codes (61, 67, 62, 21 and ##002# reset) for Israeli telecom carriers.

Inputs: carrier (required), targetNumber (required), ringSeconds.

kolivri_get_call_statusA
Read-onlyIdempotent

Retrieve structured call status, outcome, transcript, summary, appointment status, and recording URL for a Kolivri call.

Inputs: callId (required).

kolivri_place_callA

Place an outbound AI voice call via Kolivri Engine with KYC verified-caller and anti-abuse rate-limit protection.

Inputs: to (required), objective (required), verifiedCallerId (required), context, +3 more.

kolivri_preview_roiB
Read-onlyIdempotent

Calculate SMB missed-call revenue loss and recommend the matching Kolivri unified plan (Starter $69 / ₪247, Business $139 / ₪479, Pro $249 / ₪880).

Inputs: avgDealValueIls (required), missedCallsPerWeek (required), closeRatePercent, aiRecoveryRatePercent, +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: placing a call, retrieving call status, generating carrier forwarding codes, and calculating ROI. There is little risk of misselection, even between place_call and get_call_status, since they cover opposite sides of the call lifecycle.

    Naming Consistency4/5

    All tools use the same kolivri_ prefix and snake_case convention, which is highly predictable. The only minor deviation is carrier_forwarding_codes, which is a noun phrase rather than a verb_noun pattern.

    Tool Count5/5

    Four tools is well-scoped for a focused voice-call MCP server. Each tool serves a distinct workflow: outbound calling, status retrieval, carrier setup, and ROI planning.

    Completeness4/5

    The core lifecycle of placing a call and retrieving its status is covered, along with supporting carrier and ROI workflows. Minor gaps exist, such as listing past calls or canceling a call, but these are not critical for the apparent scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to make real phone calls on your behalf using VoIP, handling conversations automatically through OpenAI's Real-Time Voice API. Simply tell Claude what you want to accomplish and it will call and manage the entire conversation for you.
      25
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Turns Claude Code, Claude Desktop, Cursor, Windsurf or ChatGPT into a WhatsApp operator that knows your customers, your templates, your wallet, and your funnel.
      29
      248 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Bi-directional communication for Claude Code via Voice Calls, SMS, and WhatsApp, allowing users to call Claude, receive callbacks, and interact through multiple channels.
      81 npm
      2
      MIT