# Dialpad MCP MCP

> Dialpad equips your AI agent to handle all aspects of office communications: sending outbound business SMS texts, managing team contacts in your directory, and pulling detailed records from call logs. It connects real-world telephony operations directly into your workflow, so you never have to switch apps to send a message or check who called.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** telephony, voip, sms-messaging, call-analytics, presence-management

## Description

This MCP lets your AI agent handle everything related to your company's phone system. You can send business texts to any number and pull detailed call reports, all from the chat interface. Need to know if an employee is available? Your agent updates presence status instantly. It also manages your organization’s directory, letting you list contacts or even update details for specific people. If you build automations that need to talk about messaging and then log those actions against a client record in another system, the real power comes from chaining multiple MCPs together; Vinkius handles all of this orchestration so your agent can automate tasks across different platforms, all through one connection. You'll get full visibility into every call logged or text sent using Vinkius AI Analytics. This keeps everything auditable and visible to everyone.

## Tools

### dispatch_office_sms
Sends an outbound business text message to a specified phone number in the E.164 format.

### get_agent_profile
Retrieves structured identity details for a specific user within your organization.

### get_person_details
Pulls specific, granular properties for an individual contact in the directory.

### list_call_statistics
Gets summary data on calls, showing counts of answered, missed, or rejected attempts.

### list_ivr_departments
Identifies the precise active arrays that make up your phone system's IVR groupings.

### list_raw_call_logs
Inspects deep, detailed internal records for real-time and historical telephony activity.

### list_team_contacts
Identifies all available contacts within the business directory by reading capacity data.

### update_presence_status
Changes your displayed availability status, like 'In a Meeting' or 'Available', globally for your team.

### upsert_business_contact
Creates a new contact entry in the directory, or updates an existing one if it already exists.

### wipe_directory_entry
Permanently removes a specific contact record from your business database.

## Prompt Examples

**Prompt:** 
```
Send an SMS to '+1234567890' saying 'Your support ticket is resolved'.
```

**Response:** 
```
I've successfully sent the SMS to +1234567890 via your Dialpad account. The message is now queued for delivery. Would you like me to track its status?
```

**Prompt:** 
```
Show me the missed calls from this morning.
```

**Response:** 
```
I've found 3 missed calls from this morning, including calls from '+1987654321' and '+15550123'. Would you like me to retrieve the contact details for these numbers?
```

**Prompt:** 
```
Set my Dialpad status to 'In a meeting'.
```

**Response:** 
```
Your Dialpad presence has been updated to 'In a meeting'. Your team members will now see this status on their dashboards. Should I set an expiration time for this status?
```

## Capabilities

### Send Business Texts
Sends outbound business SMS messages to an E.164 formatted phone number.

### Retrieve Agent Profiles
Looks up specific attached rules or self-identities for a user in the directory.

### Get Contact Details
Pulls granular profile details for any person within your organization's directory.

### Check Call Logs and Statistics
Accesses real-time call records, including stats on calls that were missed or rejected.

### Identify IVR Departments
Lists the active groupings used in your Interactive Voice Response (IVR) system.

### View Raw Call Logs
Inspects deep, internal arrays containing real-time call data and history.

### List Team Contacts
Identifies all bounded routing spaces and contacts within the business directory.

## Use Cases

### The Sales Follow-Up Loop
A sales rep needs to send a quick follow-up text after a call. The agent first runs `list_call_statistics` to confirm the call was missed, then uses `get_person_details` to verify the client's title, and finally executes `dispatch_office_sms` with tailored messaging.

### Team Availability Check
The support manager needs to know who is working right now. The agent uses `list_team_contacts` to pull all employees, then checks the current status via an internal tool call before assigning a ticket.

### Boarding New Clients
An operations worker receives new client data. They use `upsert_business_contact` to add them to the directory and `get_agent_profile` to link their specific account details, completing the onboarding record.

### Compliance Review
The QA team needs proof of every call made last week. They ask the agent to run `list_raw_call_logs`, which gives them deep internal arrays that they can then analyze for compliance gaps.

## Benefits

- Send quick follow-ups. You can use `dispatch_office_sms` to send a business text the second your agent detects a ticket resolution, without opening a separate messaging app.
- Keep data clean. Use `list_team_contacts` and then `get_person_details` together to build out a verified list of contacts before sending mass messages.
- Audit everything. Instead of guessing what happened on a call, run `list_raw_call_logs` to inspect deep records when you need compliance proof or detailed troubleshooting data.
- Stay visible. Use `update_presence_status` so your team knows if you're in deep work or available for an impromptu chat—it’s instant status management.
- Handle directory changes. You can use `upsert_business_contact` to add a new client, then `wipe_directory_entry` if they leave the company, keeping your data accurate.

## How It Works

The bottom line is that you control complex business communications and call management using simple conversation.

1. Connect the Dialpad integration to your AI client using an API key found in your admin settings.
2. Authorize the connection, allowing your agent access to manage texts and telephony data.
3. Use natural language to tell your agent what you need—for example, 'Send a text to X' or 'What were the calls yesterday?'

## Frequently Asked Questions

**How do I send an SMS message with Dialpad MCP?**
You simply ask your agent to dispatch the text and provide the full E.164 number, like 'Send a text to +1555...' The agent handles the connection details for you.

**Can I list all my team members using Dialpad MCP?**
Yes. You use `list_team_contacts` to get an overview of who is in your directory, and then you can run `get_person_details` for deeper information on specific people.

**Does Dialpad MCP track missed calls?**
Yes. You can check call logs by running `list_call_statistics`, which provides counts of answered, missed, or rejected rings from the reporting period.

**How do I change my status with Dialpad MCP?**
Use the `update_presence_status` tool. Just tell your agent what to set it to—like 'Out of Office'—and it updates it for your whole team.

**What if I need to add or modify a team member's profile using the `upsert_business_contact` tool?**
Yes, you can use `upsert_business_contact`. This function lets your agent create brand new contacts or update existing ones within the Dialpad directory. It ensures all contact records are kept accurate.

**How do I determine what IVR groups are available using the `list_ivr_departments` tool?**
You use `list_ivr_departments`. This function pulls a precise array of every active department grouping set up in your main phone system. It helps you understand routing options.

**How do I permanently remove an old contact record using the `wipe_directory_entry` tool?**
You execute `wipe_directory_entry`. This action irreversibly vaporizes a specific contact entry from your database. It's best used when you are certain the data needs to be fully purged.

**How do I check detailed call metrics and rejected paths using `list_call_statistics`?**
Use `list_call_statistics`. This retrieves explicit logging data about calls, detailing specific metrics like answered, missed, or outright rejected rings. It's great for comprehensive auditing.