Skip to main content
Glama
kolivri-voice-mcp

kolivri-voice-mcp

Official
by kolivritech
README.md
# `kolivri-voice-mcp` — Real AI Phone Line for Claude Code, OpenCode, Cursor & Claude Desktop

[![kolivritech/kolivri-voice-mcp MCP server](https://glama.ai/mcp/servers/kolivritech/kolivri-voice-mcp/badges/score.svg)](https://glama.ai/mcp/servers/kolivritech/kolivri-voice-mcp)

`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](https://kolivri.com) · [app.kolivri.co.il](https://app.kolivri.co.il)

## 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`)

```bash
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`:

```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`)

```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

```bash
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

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