AI - Artificial Inteligence - VoIPstudio MCP Server¶

The VoIPstudio MCP (Model Context Protocol) server gives Claude AI direct, secure access to your VoIPstudio account data, including recordings, CDRs, live calls, and voicemails. Once connected, Claude can query calls, analyse patterns, surface agent performance issues, and generate QA reports in plain English, with no custom development required.

Add the CX Addon and each recording arrives pre-enriched with a transcript, summary, sentiment, action items, and a CX score. This dramatically reduces the AI work Claude needs to do and keeping your token use down and costs more predictable.

Getting an API key¶

The MCP server authenticates using a VoIPstudio API token. Each key is scoped to a specific user, so Claude will only be able to access data that user can access.

To generate a key:

1. In the admin dashboard, open the user you want to generate a token for.
2. Go to the API Keys section.
3. Enter a name for the key — for example, Claude MCP.
4. Click Add.
5. Click the eye icon to reveal the API key / user_token. Copy this value.
6. To view further details or delete the key, click the gear icon and select Show Details.

Note: The API key remains valid as long as it is used at least once every 7 days (default timeout). Set a longer timeout (or unlimited) if needed before clicking Add.

See REST API documentation

Connecting to Claude¶

VoIPstudio is not currently listed in the Claude.ai connector directory. You add it manually as a custom MCP server.

MCP server URL¶

Steps (Claude.ai)¶

1. In Claude.ai, go to Settings → Integrations (or the connectors panel, depending on your plan).
2. Choose Add custom MCP server (or equivalent).
3. Enter the MCP server URL above.
4. When prompted for authentication, provide your VoIPstudio API key.
5. Save and authorise the connection.

Claude can now call VoIPstudio tools in any conversation. The first time a tool is called in a session, Claude will ask you to confirm data sharing. Click Always allow to skip this prompt in future sessions.

Anthropic API (for developers)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

Connecting to other AI platforms¶

Most AI platforms that support external MCPs can connect to the VoIPstudio MCP server using the same URL and API key. The exact configuration steps will vary by platform. Look for an option labelled external MCP server, custom MCP, or remote MCP in your platform's integrations or settings.

CX Addon¶

Without the CX Addon, recordings arrive as raw metadata. Claude must transcribe and analyse each call itself, consuming significant tokens per recording.

With the CX Addon, VoIPstudio handles transcription, summarisation, sentiment analysis, action extraction, and CX scoring on its own infrastructure at a fixed monthly cost with no per-call fees and no transcription limits. Claude receives finished intelligence — ready to reason over immediately.

Fields unlocked by CX Addon¶

Tools Reference¶

The simplicity of MCP integration means that complex APIs don’t need to be understood and, instead, simple prompts can help with AI platform make sense of the data provided from Voipstudio and reply with an appropriate response.

However, some more technical users may wish to know what is going on “under the hood”, so below is a reference guide to some of the MCP server functions.

get_recordings¶

Returns call recordings. With the CX Addon active, each record includes the transcript, summary, sentiment, CX score, and timeline. Without the addon, these fields return null.

Parameters

Response fields

Example – Low CX scores this week

Ask Claude: "Show me all recordings from this week where the CX score was below 6, grouped by agent, with a summary of what went wrong on each call."

Claude calls the tool with:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

Call Detail Records – the raw log of every call leg. Use for volume stats, cost analysis, duration distributions, and agent activity summaries. Available without the CX Addon.

Parameters: same as get_recordings (filters, limit, page)

Key response fields

get_live_calls¶

Returns a real-time snapshot of all active calls on your account. No parameters required.

Example: "How many calls are in progress right now, and which agents are on them?"

get_voicemails¶

Fetches voicemail messages. Same filters, limit, and page interface as other tools.

Key filterable fields: src, dst, calldate, duration, listened

get_recording_audio¶

Returns a direct download URL for the MP3 audio of a specific recording.

Parameter: id (number) — the id field from a get_recordings response.

Filtering & Pagination¶

All list tools accept an optional filters array. Each filter object has three properties:

Common examples¶

Date range

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

CX score threshold

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

Specific agent

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

Connected calls only

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

Inbound calls over 5 minutes

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

Use Cases¶

gent QA report¶

"Give me a QA summary for each agent this month — CX score averages, common complaint themes, and their three lowest-scoring calls with summaries."

Call centre volume stats¶

"What was our call volume by day this week? What was our average handle time, and how many calls went unanswered?"

Sentiment trend analysis¶

"Is customer sentiment improving or declining compared to last month? Which call topics correlate with negative sentiment?"

Missed call follow-up list¶

"List all missed inbound calls from the last 24 hours with caller IDs, so I can prioritise callbacks."

Cost & billing review¶

"Which extensions have made the most expensive outbound calls this quarter?"

ive operations check¶

"How many agents are currently on calls, and are there any calls that have been running over 20 minutes?"

Token Efficiency¶

Each call Claude analyses without the CX Addon requires Claude to process audio content and generate its own transcription and analysis. The CX Addon offloads this entirely to VoIPstudio:

What VoIPstudio handles (fixed monthly cost, unlimited calls):

• Audio transcription
• Speaker diarisation
• Call summarisation
• Sentiment classification
• Action item extraction
• CX scoring

What Claude receives: Clean, structured text fields ready for reasoning, comparison, and reporting.

This means you can ask Claude to analyse hundreds of calls in a single session at a fraction of the token cost, making large-scale QA, trend analysis, and agent coaching reports practical without unpredictable AI spend.