# Vibrato MCP

> Vibrato MCP manages automated, human-like phone calls for your AI agent. It lets you programmatically start calls to book appointments, negotiate bills, or gather information over the phone without manual intervention. You just provide a prompt or select a predefined script (template), and the agent handles the entire conversation using natural language processing.

## Overview
- **Category:** superpower
- **Price:** Free
- **Tags:** ai-calling, automated-negotiation, appointment-booking, voice-assistant, telephony-automation, natural-language-processing

## Description

Calling people is always messy. Whether it’s calling customer service lines to dispute a bill or scheduling follow-ups with potential clients, you end up wasting time on awkward conversations, holding for minutes, and repeating information. This MCP changes that. You connect your agent once from any compatible client, and instead of having the AI write an email, it actually makes the call.

The agent uses natural language to speak to people outside of your system. It can follow complex scripts designed for specific outcomes, like negotiating a Comcast bill or confirming doctor hours. If you're building multi-step workflows that need external human interaction—like combining this MCP with a messaging tool and a billing tool—the entire process runs securely through Vinkius. The platform ensures credentials pass through a zero-trust proxy, meaning your sensitive keys are used only in transit and never stored on disk. This lets you build automated operations that span multiple platforms while keeping everything locked down.

## Tools

### create_call_from_template
Initiates a call that automatically follows the specific steps of a predefined script, such as 'Negotiate Bill'.

### create_call
Starts an AI-powered phone call by giving it a natural language prompt and the target number.

### get_call_status
Checks the current progress of an active phone call to see if it's still happening or finished.

### list_calls
Retrieves a list and metadata for every single AI-initiated call that has ever run through the system.

### list_templates
Shows all available, structured calling templates you can use to build an automated workflow.

## Prompt Examples

**Prompt:** 
```
Call +123456789 to negotiate my internet bill using the 'Telecom Negotiation' template.
```

**Response:** 
```
I've initiated the AI call to negotiate your bill. You can track the progress and see the final outcome here: [View Call Status].
```

**Prompt:** 
```
Book a dentist appointment at 'City Dental' (+198765432) for next Tuesday morning.
```

**Response:** 
```
Call started! The AI agent is currently speaking with City Dental to secure your appointment. I'll provide the confirmation details shortly.
```

**Prompt:** 
```
Show the transcript for my last call.
```

**Response:** 
```
I've retrieved the transcript. The AI successfully negotiated a $20/month discount on your plan. Here is the full conversation: [View Transcript].
```

## Capabilities

### Initiate calls with prompts
Start a phone call immediately using any natural language prompt and the target phone number.

### Run scripted tasks
Execute predefined calling scripts, like 'Negotiate Comcast Bill', for high-success rate automation.

### Track live call status
Get real-time updates on whether an ongoing AI call is still active or has concluded.

### Review call history
List and access detailed recordings, transcripts, and metadata for all past automated calls.

### Manage available scripts
See a list of all the structured calling templates that can be used in automation workflows.

## Use Cases

### The overdue service appointment
A manager needs to contact five different clients to reschedule maintenance. Instead of dialing and leaving voicemails, they use the agent with `create_call` for each client. The AI handles the back-and-forth rescheduling until a new time slot is confirmed.

### Billing dispute automation
A user needs to challenge an internet bill increase. They select the 'Negotiate Bill' template and run `create_call_from_template`. The agent speaks with the company, using the script to argue for a discount, all while tracking progress via `get_call_status`.

### Market research lead generation
A sales team wants to qualify 20 leads. They use the agent and `create_call` with a custom prompt for each number. The AI gathers specific information (like annual revenue or key decision-makers) that they can then compile later.

### Post-campaign follow-up
After an event, you need to check in with attendees. You run `list_calls` and review the transcripts from previous interactions to ensure all open items were addressed before sending a summary email.

## Benefits

- Saves time on routine calls. Instead of manually dialing and waiting, your agent handles everything from booking appointments to confirming details using `create_call`.
- Guaranteed consistency through scripting. When you need high-success rate automation (like negotiating a bill), use `create_call_from_template` to enforce the exact conversation flow every time.
- Never lose data. Every call creates an audit trail, and calling `list_calls` lets you pull detailed transcripts and metadata for later review.
- Works globally. You can initiate calls in different languages and locales, letting your agent connect with businesses anywhere in the world.
- Always secure. Credentials pass through a zero-trust proxy managed by Vinkius, so your keys never sit on disk—period.

## How It Works

The bottom line is that your AI client can talk to the real world over the phone without you having to lift a finger.

1. First, you connect your Vibrato API key to the Vinkius platform.
2. Next, you tell your agent what needs to happen. You either give it a specific conversational prompt or select an automated template (like 'Schedule Appointment').
3. The agent initiates the call, handles the dialogue, and then returns a status update and/or a final summary of the conversation.

## Frequently Asked Questions

**How do I get my Vibrato API Key?**
Log in to your account at [getvibrato.com](https://getvibrato.com/), navigate to the API Keys section, and copy your unique secret key.

**Does it provide call recordings?**
Yes, you can access call recordings and live transcripts through the `get_call_status` tool once a call is in progress or completed.

**Can I use custom prompts?**
Absolutely. The `create_call` tool allows you to provide a custom natural language prompt to define exactly what the AI should achieve during the call.

**How do I find out what types of automated calls I can make using list_templates?**
It lists all pre-built, successful calling scenarios. This lets you see the scripts available—like 'Negotiate Comcast Bill'—so you don't have to write a complex prompt every time.

**If an automated call is running long, how do I check its progress using get_call_status?**
It gives you the real-time state of the connection. You instantly know if the AI is still connecting, actively negotiating, or if something has failed before it gets disconnected.

**When I use create_call, how do I ensure the AI speaks the correct language for a foreign business?**
You pass the specific locale code in the request body. This ensures that regardless of where you're calling, the agent handles the conversation and dialect correctly.

**After running several automated calls, how do I find all my records using list_calls?**
It pulls a history record for every single call attempt. You can quickly review metadata and confirm that your previous AI interactions were logged properly for later auditing.

**What's the difference between using create_call versus create_call_from_template?**
Use `create_call` when you have a unique, one-off task to run. Use `create_call_from_template` for high-success rate tasks; it leverages proven scripts designed for specific outcomes.