{
  "markdown": "# @getdial/cli\n\n[![smithery badge](https://smithery.ai/badge/getdial-ai/dial)](https://smithery.ai/servers/getdial-ai/dial)\n\nThe official command-line interface for [Dial](https://getdial.ai) — 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](https://docs.getdial.ai) so you never have to write HTTP code.\n\n## Installation\n\nInstall globally from npm:\n\n```bash\nnpm install -g @getdial/cli\n```\n\nOr use the bootstrap script, which installs the CLI and walks you through sign-up:\n\n```bash\ncurl -fsSL https://getdial.ai/install | bash\n```\n\nRequires **Node.js 22.19+**.\n\n## Quick start\n\n```bash\ndial signup you@example.com      # email a 6-digit sign-up code\ndial onboard --code 123456 \\     # verify the code and provision your account\n  --inbound-instruction \"You are my receptionist. Greet the caller and find out what they need.\"\ndial doctor                      # check account state and what to do next\n```\n\nOnce onboarded, your API key is saved locally and the CLI uses it automatically.\n\n```bash\n# Send an SMS\ndial message --to +14155550123 --body \"Hello from Dial\"\n\n# Place an AI voice call\ndial call --to +14155550123 --outbound-instruction \"You are a helpful scheduling assistant.\"\n\n# Wait for an inbound event (e.g. a verification code)\ndial wait-for message.received --field to=+14155550123\n```\n\n## Commands\n\n| Command | Description |\n| --- | --- |\n| `dial doctor` | Report account state and what to do next. |\n| `dial signup <email>` | Email a 6-digit sign-up code. |\n| `dial onboard --code <code>` | Verify the code and finish onboarding. |\n| `dial number list` | List the phone numbers on your account. |\n| `dial number purchase` | Purchase an additional phone number. |\n| `dial number set <number>` | Update a number's inbound instruction. |\n| `dial message` | Send an SMS. |\n| `dial message list` | List recent messages. |\n| `dial message reply` | Reply or react to a message. |\n| `dial call` | Place an outbound AI voice call. |\n| `dial call list` | List recent calls. |\n| `dial call get <id>` | Fetch a single call — status, duration, transcript. |\n| `dial wait-for <event>` | Block until a matching account event arrives. |\n| `dial listen install` | Install the background event daemon. |\n| `dial listen status` | Report the daemon's state and recent events. |\n| `dial listen uninstall` | Stop and remove the daemon. |\n| `dial local-target add url <url>` | Fan out events to a local HTTP endpoint. |\n| `dial local-target add cmd <path>` | Run an executable once per event. |\n| `dial local-target list` | List registered fan-out targets. |\n| `dial local-target remove <id>` | Unregister a fan-out target. |\n| `dial mcp` | Run a local stdio MCP server exposing every command as an agent tool. |\n\nRun `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).\n\n## Configuration\n\n| Variable | Description |\n| --- | --- |\n| `DIAL_API_URL` | Target a non-default Dial deployment. |\n\nYour API key is stored at `~/.local/share/dial/auth.json` (honoring `XDG_DATA_HOME`).\n\n## Use from an AI agent\n\nThe CLI ships with a [skill](https://docs.getdial.ai/integrations/tools/cli-skill) that teaches AI coding agents how to drive `dial`. Install it into your agent's config during onboarding:\n\n```bash\ndial onboard --code 123456 --agent claude-code\n```\n\nSupported agents: `claude-code`, `cursor`, `codex`, `opencode`, `pi`, `openclaw`, `nanoclaw`, `hermes`.\n\n## Local MCP server\n\n`dial mcp` runs a local [Model Context Protocol](https://modelcontextprotocol.io) 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 onboard` (no OAuth, no config). It's the local counterpart to the hosted [Remote MCP](https://docs.getdial.ai/integrations/tools/remote-mcp) server, with the same operational tools plus the local-only verbs (`signup`, `onboard`, `listen`, `local-target`).\n\n```bash\n# Claude Code, for example\nclaude mcp add dial -- dial mcp\n```\n\nSee the [Local MCP](https://docs.getdial.ai/integrations/tools/local-mcp) docs for client setup.\n\n## Documentation\n\nFull documentation lives at **[docs.getdial.ai](https://docs.getdial.ai)** — including the [CLI reference](https://docs.getdial.ai/documentation/cli/commands) and the [listen service](https://docs.getdial.ai/documentation/cli/listen-service) guide.\n\n## License\n\nMIT\n",
  "bytes": 4619,
  "sha": "51f6d3776a8761212c542055dc85990eab9522e70ebcb53d0a87c0d82227da33",
  "repo_slug": "getdial-ai/cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_getdial_ai_dial_60d7d220/readme"
}