Dial MCP server
Commit Nov 12, 2026Lets an AI client provision phone numbers, send SMS, place AI voice calls, and react to inbound communication events.
Also known as GetDial-AI/cli, cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Nov 12, 2026
- License
- —
What is Dial MCP?
Dial lets an AI client provision phone numbers, send SMS, place AI voice calls, and react to inbound communication events.
Summary generated from the project's README
About Dial MCP server
Dial provides a communication stack designed specifically for AI agents to manage telephony tasks. Developers can use this tool to provision new phone numbers, send SMS messages, and initiate outbound AI voice calls with custom instructions. It functions as a command-line interface that wraps the Dial REST API, removing the need for manual HTTP requests.
Users can run a local MCP server via the dial mcp command, which exposes all CLI functionality as tools for an AI client using stdio. This local setup reuses the API key stored during the authentication process. For those using specific environments like Cursor or Grok Bot, a hosted remote MCP server is also available. The system requires Node.js 22.19 or higher and an account verified by both an email address and a phone number.
What you can do with it
- 1Automate outbound voice callsAn AI agent can place a phone call to a specific number using a custom persona or instruction.
- 2Send text messagesA developer can instruct an AI to send an SMS message to a recipient.
- 3React to incoming messagesThe system can wait for a specific inbound event, such as a received message, before proceeding.
- 4Manage phone number settingsYou can update the default instructions that an AI follows when receiving an inbound call.
Written from the project's README. Every use case is checked against a quote from it.
How to install Dial MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Dial MCP in Claude Code
$ claude mcp add --transport http cli https://getdial.ai/mcpInstall Dial MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"url": "https://getdial.ai/mcp"
}
}
}Install Dial MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "http",
"url": "https://getdial.ai/mcp"
}
}
}Install Dial MCP in VS Code CLI
$ code --add-mcp '{"name":"cli","type":"http","url":"https://getdial.ai/mcp"}'Install Dial MCP in Codex
$ codex mcp add cli --url https://getdial.ai/mcpInstall Dial MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] url = "https://getdial.ai/mcp"
Install Dial MCP in Gemini CLI
$ gemini mcp add -s user --transport http cli https://getdial.ai/mcpInstall Dial MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"url": "https://getdial.ai/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegetdial-ai/cli is public and reachablegithub.com/getdial-ai/cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/getdial-ai/cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHub@getdial/cli
The official command-line interface for Dial — a communication stack for AI agents. Provision phone numbers, send SMS, place AI voice calls, and react to inbound events, all from your terminal. The CLI wraps the Dial REST API so you never have to write HTTP code.
Installation
Install globally from npm:
npm install -g @getdial/cli
Or use the bootstrap script, which installs the CLI and walks you through sign-up:
curl -fsSL https://getdial.ai/install | bash
Requires Node.js 22.19+.
Quick start
dial auth login you@example.com # email a 6-digit sign-up code
dial auth verify-otp --code 123456 # verify your email
dial auth register-number +14155550123 # text a code to your phone
dial auth verify-otp --number --code 654321 # verify your phone — creates the account
dial doctor # check account state and what to do next
Creating an account needs a verified email and a verified phone number. Each step prints the command to run next, so you don't have to memorize the flow.
Signing in to an account you already have needs only the first two steps — you're never asked for a phone number again.
The number you register can receive SMS and becomes permanently linked to that account: a number can register only one Dial account. A Dial number can't be used.
Once the account exists, your API key is saved locally and the CLI uses it automatically. Your first number starts with a default inbound voice-agent prompt — change it with dial number set <number> --inbound-instruction "...".
# Send an SMS
dial message --to +14155550123 --body "Hello from Dial"
# Place an AI voice call
dial call --to +14155550123 --outbound-instruction "You are a helpful scheduling assistant."
# Wait for an inbound event (e.g. a verification code)
dial wait-for message.received --field to=+14155550123
Commands
| Command | Description |
|---|---|
dial doctor |
Report account state and what to do next. |
dial auth login <email> |
Email a 6-digit sign-up code. --coupon <code> signs up past a signup pause and adds the coupon's credit. |
dial auth verify-otp --code <code> |
Verify an email code, or with --number a texted one. |
dial auth register-number <phone> |
Text a code to the phone number that will own the account. |
dial number list |
List the phone numbers on your account. |
dial number purchase |
Purchase an additional phone number. |
dial number set <number> |
Update a number's inbound instruction. |
dial message |
Send an SMS. |
dial message list |
List recent messages. |
dial message reply |
Reply or react to a message. |
dial call |
Place an outbound AI voice call. |
dial call list |
List recent calls. |
dial call get <id> |
Fetch a single call — status, duration, transcript. |
dial wait-for <event> |
Block until a matching account event arrives. |
dial listen install |
Install the background event daemon. |
dial listen status |
Report the daemon's state and recent events. |
dial listen uninstall |
Stop and remove the daemon. |
dial local-target add url <url> |
Fan out events to a local HTTP endpoint. |
dial local-target add cmd <path> |
Run an executable once per event. |
dial local-target list |
List registered fan-out targets. |
dial local-target remove <id> |
Unregister a fan-out target. |
dial mcp |
Run a local stdio MCP server exposing every command as an agent tool. |
Run dial --help for the full command tree, or dial <command> --help for a specific command's flags. Every command accepts --json for machine-readable output (except dial mcp, which speaks JSON-RPC on stdout).
Configuration
| Variable | Description |
|---|---|
DIAL_API_URL |
Target a non-default Dial deployment. |
Your API key is stored at ~/.local/share/dial/auth.json (honoring XDG_DATA_HOME).
Use from an AI agent
The CLI ships with a skill that teaches AI coding agents how to drive dial. Install it into your agent's config during onboarding:
dial auth verify-otp --code 123456 --agent claude-code
Supported agents: claude-code, cursor, codex, opencode, pi, openclaw, nanoclaw, hermes.
Grok Bot and Cursor plugin
plugins/dial is a plugin for Grok Bot, Grok Build and Cursor. It connects the agent to the hosted MCP server at https://getdial.ai/mcp (browser sign-in, no CLI or API key needed) and adds skills plus four commands: /dial-inbox, /dial-followups, /dial-report and /dial-call-summary. Check it with node scripts/validate-plugin.mjs.
Local MCP server
dial mcp runs a local Model Context Protocol server over stdio, exposing every command as an agent tool. Point a local MCP client at dial mcp as the server command — it reuses the API key saved by dial auth verify-otp (no OAuth, no config). It's the local counterpart to the hosted Remote MCP server, with the same operational tools plus the local-only verbs (auth, listen, local-target).
# Claude Code, for example
claude mcp add dial -- dial mcp
See the Local MCP docs for client setup.
Documentation
Full documentation lives at docs.getdial.ai — including the CLI reference and the listen service guide.
License
MIT
Dial MCP questions
How do I add Dial MCP to Claude Code?
Run claude mcp add --transport http cli https://getdial.ai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Dial MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I use the same phone number for multiple Dial accounts?
No, a phone number can only be linked to one Dial account and is permanently linked once registered.
How can I automate reactions to incoming messages?
You can use the dial listen command to install a background event daemon or use dial local-target to fan out events to local HTTP endpoints or executables.