kolivri-voice-mcp
Officialkolivri-voice-mcp — Real AI Phone Line for Claude Code, OpenCode, Cursor & Claude Desktop
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-6732Israel 24/7 Live AI Phone Line:
074-760-5550(+972-74-760-5550)Support & Partnerships:
stas@kolivri.com· WhatsApp054-787-5670Web & Onboarding: kolivri.com · app.kolivri.co.il
Related MCP server: Arara MCP
Features & Tools
kolivri_place_call— Trigger an outbound AI voice call viaPOST ${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, defaulthe).Enforces KYC verified-caller checks (
verifiedCallerId+ optionalKOLIVRI_VERIFIED_CALLER_IDallowlist).Enforces per-key sliding-window rate limits (
KOLIVRI_MAX_CALLS_PER_MINUTE, default5/min) to prevent robocall loops.
kolivri_get_call_status— Fetch call status, structured outcome, transcript, summary, appointment status, and recording URL.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).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 |
| Yes (for live calls) | — | Kolivri API key sent in |
| Optional |
| Default Kolivri campaign/engine webhook ID |
| Optional | — | Comma-separated KYC-verified caller IDs in E.164 or Israeli format |
| Optional |
| Kolivri API base URL |
| Optional |
| 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.mjs2. 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-mcpRunning Tests
node --test kolivri-voice-mcp/test/voice-mcp.test.mjsAvailable Tools
4 toolskolivri_carrier_forwarding_codesARead-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_statusARead-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_roiBRead-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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Claude makes real phone calls for you — in many languages, with transcript and outcome back in chat.
Phone calls from Claude or ChatGPT: a personal AI agent that calls for you, and an AI receptionist.
Lets Claude, Cursor or any MCP client build voice agents and place real phone calls.
Give any AI agent a phone: make and answer calls, get through phone menus, and send texts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.25MIT
- AlicenseBqualityBmaintenanceTurns Claude Code, Claude Desktop, Cursor, Windsurf or ChatGPT into a WhatsApp operator that knows your customers, your templates, your wallet, and your funnel.29248 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to make and manage real phone calls through Twilio, allowing it to think, search, and respond in real-time conversations.MIT
- AlicenseNot gradedqualityCmaintenanceBi-directional communication for Claude Code via Voice Calls, SMS, and WhatsApp, allowing users to call Claude, receive callbacks, and interact through multiple channels.81 npm2MIT