关于 Dial
Dial 是面向 AI Agent 的通信命令行工具，可管理电话号码、短信和 AI 语音通话。它还可等待账户事件，并通过本地 MCP 服务将命令提供给 Agent。
主要功能
- 01管理和购买电话号码
- 02发送、查看及回复短信
- 03发起 AI 语音通话
- 04等待并分发账户事件
- 05提供本地 MCP 服务
适用场景
- 01通过短信发送验证码或通知
- 02让 AI Agent 拨打外呼电话
- 03等待收到的短信等事件
- 04将通信命令接入 MCP 客户端
MCP 相关
`dial mcp` 通过标准输入输出运行本地 MCP 服务，将 CLI 命令作为工具提供给 Agent，并复用本地保存的 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://getdial.ai/mcpclaude mcp add --transport http cli-getdial-ai https://getdial.ai/mcp{"mcpServers":{"cli-getdial-ai":{"type":"http","url":"https://getdial.ai/mcp"}}}在 Cursor 中打开{"servers":{"cli-getdial-ai":{"type":"http","url":"https://getdial.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"cli-getdial-ai":{"type":"http","url":"https://getdial.ai/mcp"}}}{"mcpServers":{"cli-getdial-ai":{"serverUrl":"https://getdial.ai/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@getdial/cli
Dial 的官方命令行界面——面向 AI Agent 的通信技术栈。通过终端即可配置电话号码、发送 SMS、拨打 AI 语音电话并响应入站事件。此 CLI 封装了 Dial REST API，让你无需编写 HTTP 代码。
安装
从 npm 全局安装：
npm install -g @getdial/cli
也可以使用引导脚本，它会安装 CLI 并引导你完成注册：
curl -fsSL https://getdial.ai/install | bash
需要 Node.js 22.19+。
快速开始
dial auth login [email protected] # 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
创建账户需要经过验证的电子邮件和电话号码。每个步骤都会显示下一步要运行的命令，因此你无需记住整个流程。
登录已有账户只需完成前两个步骤——之后不会再要求你提供电话号码。
你注册的号码可以接收 SMS，并会永久绑定到该账户：一个号码只能注册一个 Dial 账户。Dial 号码不能重复使用。
账户创建完成后，你的 API 密钥会保存在本地，CLI 会自动使用该密钥。你的第一个号码会采用默认的入站语音 Agent 提示词——使用 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
命令
| 命令 | 说明 |
|---|---|
dial doctor | 报告账户状态以及下一步操作。 |
dial auth login <email> | 发送 6 位注册验证码到电子邮件。--coupon <code> 可在暂停注册期间完成注册，并添加优惠券额度。 |
dial auth verify-otp --code <code> | 验证电子邮件验证码；使用 --number 时则验证通过短信发送的验证码。 |
dial auth register-number <phone> | 向将用于账户的电话号码发送验证码。 |
dial number list | 列出账户中的电话号码。 |
dial number purchase | 购买额外的电话号码。 |
dial number set <number> | 更新号码的入站指令。 |
dial message | 发送 SMS。 |
dial message list | 列出最近的消息。 |
dial message reply | 回复消息或对消息作出回应。 |
dial call | 拨打外呼 AI 语音电话。 |
dial call list | 列出最近的通话。 |
dial call get <id> | 获取单条通话记录——状态、时长和转录文本。 |
dial wait-for <event> | 阻塞，直至收到匹配的账户事件。 |
dial listen install | 安装后台事件守护进程。 |
dial listen status | 报告守护进程状态和最近的事件。 |
dial listen uninstall | 停止并移除守护进程。 |
dial local-target add url <url> | 将事件转发到本地 HTTP 端点。 |
dial local-target add cmd <path> | 每次事件触发时运行一次可执行文件。 |
dial local-target list | 列出已注册的事件转发目标。 |
dial local-target remove <id> | 注销事件转发目标。 |
dial mcp | 运行本地 stdio MCP 服务，将每个命令作为 Agent 工具公开。 |
运行 dial --help 查看完整命令树，或运行 dial <command> --help 查看特定命令的标志。每个命令都支持 --json，用于输出机器可读内容（dial mcp 除外，它会通过 stdout 使用 JSON-RPC 通信）。
配置
| 变量 | 说明 |
|---|---|
DIAL_API_URL | 指定非默认的 Dial 部署。 |
你的 API 密钥存储在 ~/.local/share/dial/auth.json（遵循 XDG_DATA_HOME）。
在 AI Agent 中使用
CLI 附带一个 技能，用于指导 AI 编码 Agent 如何使用 dial。在引导过程中将其安装到 Agent 的配置中：
dial auth verify-otp --code 123456 --agent claude-code
支持的 Agent：claude-code、cursor、codex、opencode、pi、openclaw、nanoclaw、hermes。
本地 MCP 服务
dial mcp 通过标准输入/输出运行本地 Model Context Protocol 服务，将每条命令都作为 Agent 工具提供。将本地 MCP 客户端指向 dial mcp 作为服务命令即可——它会复用通过 dial auth verify-otp 保存的 API 密钥（无需 OAuth 或配置）。它是托管式 Remote MCP 服务的本地对应版本，提供相同的运维工具，以及仅限本地使用的动词（auth、listen、local-target）。
# Claude Code, for example
claude mcp add dial -- dial mcp
客户端设置请参阅 Local MCP 文档。
文档
完整文档请访问 docs.getdial.ai，其中包括 CLI 参考和 listen 服务指南。
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。