How to Use the Dialpad MCP in Mastra AI

Q: How do I add Dialpad MCP Server tools to a Mastra AI agent?

Instantiate the client using @mastra/mcp@latest and point it to your Vinkius MCP Server URL. Use listTools() to retrieve the operations, then spread them directly into your agent's tool configuration array.

Q: Can Mastra AI handle human approval for Dialpad directory changes?

Yes, you can set requireToolApproval on operations like wipedirectoryentry. The Mastra AI workflow pauses until an administrator approves the deletion.

Q: How does Mastra AI query Dialpad call statistics?

The agent invokes listcallstatistics via the MCP client to inspect rejected call paths. It analyzes the failure patterns and automatically routes alerts to your support team when drop rates spike.

Q: Can we build multi-step contact workflows?

Agents run multi-step workflows by fetching details with getpersondetails and then running upsertbusinesscontact to update external extensions.

Q: How does Mastra AI protect Dialpad contact directories under the MCP standard?

Every transaction involving upsertbusinesscontact runs in an isolated V8 sandbox. Your customer contact databases and status logs are processed in-memory and never cached on disk, complying with strict enterprise privacy standards.

Run autonomous Dialpad contact sync and SMS retry workflows using Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dialpad MCP to Mastra AI

Create your Vinkius account to connect Dialpad to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Dialpad with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated SMS retry loops in Mastra AI

The `dispatch_office_sms` tool drives automated Dialpad text sequences within your Mastra AI agent using this MCP Server. If a transactional Dialpad text fails, the Mastra AI framework triggers an automatic retry with exponential backoff. You define the Dialpad error threshold, and the Mastra AI agent manages the rest. It guarantees that critical Dialpad office alerts reach the customer without requiring a developer to build custom queuing logic in Mastra AI.

Conditional directory cleanup

The `wipe_directory_entry` tool executes permanent Dialpad contact deletions only after your Mastra AI workflow verifies the contact's status. The Mastra AI agent checks active databases before severing the Dialpad directory link. This Dialpad workflow relies on the Mastra AI framework's human-in-the-loop feature. You can require manual approval in the Mastra AI console before the agent destroys any Dialpad business directory record.

Dynamic agent status routing

The `update_presence_status` tool modifies your team's Dialpad status strings based on Mastra AI workflow triggers. Mastra AI agents coordinate this to prevent Dialpad calls from routing to busy team members. If an agent goes on break, the Mastra AI workflow updates their Dialpad presence automatically. This keeps Dialpad call routing clean without relying on Mastra AI agents remembering to toggle their status manually.

Setup guide

Set up Dialpad MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Dialpad tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "dialpad-mcp-client",
  servers: {
    "dialpad-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Dialpad Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Dialpad tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Dialpad transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Dialpad. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Dialpad now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Dialpad MCP in Mastra AI

Instantiate the client using `@mastra/mcp@latest` and point it to your Vinkius MCP Server URL. Use `listTools()` to retrieve the operations, then spread them directly into your agent's tool configuration array.

Yes, you can set `requireToolApproval` on operations like `wipe_directory_entry`. The Mastra AI workflow pauses until an administrator approves the deletion.

The agent invokes `list_call_statistics` via the MCP client to inspect rejected call paths. It analyzes the failure patterns and automatically routes alerts to your support team when drop rates spike.

Agents run multi-step workflows by fetching details with `get_person_details` and then running `upsert_business_contact` to update external extensions.

Every transaction involving `upsert_business_contact` runs in an isolated V8 sandbox. Your customer contact databases and status logs are processed in-memory and never cached on disk, complying with strict enterprise privacy standards.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript