Phone numbers for AI agents: get a number, read texted verification codes, place AI voice calls.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. 'Bearer YOUR_API_KEY'. Leave out to let the agent call sign_up and get its own key.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Show your plan, limits, free credit and billing status, whether your email is confirmed, and texts received this month.
Your Dial API key (from sign_up)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http dial https://aloha-dial-api.onrender.com/mcp
Headers
Authorization (optional, not in the config above): Optional. 'Bearer YOUR_API_KEY'. Leave out to let the agent call sign_up and get its own key.Show your plan, limits, free credit and billing status, whether your email is confirmed, and texts received this month.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}Get the result of a call from make_phone_call: status, outcome, summary and transcript. Waits up to wait_seconds for the call to finish; if it's still going, call again.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
| call_id* | string | |
| wait_seconds | integer | How long to wait for the call to end (default 90) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"call_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"call_id": {
"type": "string"
},
"wait_seconds": {
"type": "integer",
"maximum": 120,
"minimum": 0,
"description": "How long to wait for the call to end (default 90)"
}
},
"additionalProperties": false
}Get a phone number for this agent. Returns your existing number if you already have one, otherwise provisions a new one. Use it when a website or service asks for a phone number.
| Argument | Type | Description |
|---|---|---|
| label | string | Note for yourself, e.g. 'signups' |
| api_key* | string | Your Dial API key (from sign_up) |
| area_code | string | Preferred US/CA area code, e.g. 310 |
| force_new | boolean | Provision another number even if one exists |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"label": {
"type": "string",
"maxLength": 100,
"description": "Note for yourself, e.g. 'signups'"
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"area_code": {
"type": "string",
"pattern": "^\\d{3}$",
"description": "Preferred US/CA area code, e.g. 310"
},
"force_new": {
"type": "boolean",
"description": "Provision another number even if one exists"
}
},
"additionalProperties": false
}List recent calls, newest first. Use direction 'inbound' to read calls people made to your number: the AI answers them, takes a message, and the summary and transcript are here.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| api_key* | string | Your Dial API key (from sign_up) |
| direction | string | 'inbound' = calls to your number (messages); 'outbound' = calls you placed |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"direction": {
"enum": [
"inbound",
"outbound"
],
"type": "string",
"description": "'inbound' = calls to your number (messages); 'outbound' = calls you placed"
}
},
"additionalProperties": false
}List the phone numbers this account owns.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}List the voices you can use on calls, each with its gender, accent and personality. Pass the id as make_phone_call's voice.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}Have an AI voice assistant phone a business or person for your human, from your Dial number: book a table, make an appointment, ask a question. It introduces itself as an AI assistant calling on behalf of your human, works toward the goal, and stays within your limits; anything outside them it notes for a callback. Returns a call id at once. Then call get_call_result to wait for the outcome, summary and transcript. US and Canadian numbers only; one call at a time.
| Argument | Type | Description |
|---|---|---|
| to* | string | Number to call, e.g. +13105551234 |
| goal* | string | What the call should achieve, e.g. 'Book a table for 2 this Saturday at 7pm' |
| voice | string | Voice persona from list_voices, e.g. 'brian' (calm male) or 'sarah' (warm female). 'male'/'female' also work. |
| api_key* | string | Your Dial API key (from sign_up) |
| details | string | Facts the assistant may share: reservation name, party size, a callback number, preferences |
| number_id* | string | id of your number (from get_phone_number); the call comes from it |
| may_agree_to | string | Limits, e.g. 'any time 6:30-8:30pm; no deposit'. Without this it agrees only to exactly the goal. |
Get a Stripe Customer Portal session URL. Your human opens it to update the card, switch between Starter, Pro and Scale, or cancel. Returns { url }.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}Read recent text messages received on one of your numbers.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| api_key* | string | Your Dial API key (from sign_up) |
| number_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"number_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"number_id": {
"type": "string"
}
},
"additionalProperties": false
}Give up a phone number you no longer need. You will stop receiving texts on it.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
| number_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"number_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"number_id": {
"type": "string"
}
},
"additionalProperties": false
}Send a new email-confirmation link to your account's address (if the first one expired or got lost).
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}Set how the AI answers when someone calls your number. It always says it's an AI assistant and takes a message; these settings personalize it.
| Argument | Type | Description |
|---|---|---|
| voice | string | Voice persona from list_voices, e.g. 'brian' |
| api_key* | string | Your Dial API key (from sign_up) |
| number_id* | string | id of your number |
| owner_name | string | Your human's name, e.g. 'Berk'. The greeting says '<assistant>, <owner>'s AI assistant' |
| instructions | string | Extra guidance, e.g. 'If it's about the Capri booking, ask for their confirmation number.' |
| assistant_name | string | Your own first name, e.g. 'Lloyd' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"number_id"
],
"properties": {
"voice": {
"type": "string",
"description": "Voice persona from list_voices, e.g. 'brian'"
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"number_id": {
"type": "string",
"description": "id of your number"
},
"owner_name": {
"type": "string",
"maxLength": 80,
"description": "Your human's name, e.g. 'Berk'. The greeting says '<assistant>, <owner>'s AI assistant'"
},
"instructions": {
"type": "string",
"maxLength": 800,
"description": "Extra guidance, e.g. 'If it's about the Capri booking, ask for their confirmation number.'"
},
"assistant_name": {
"type": "string",
"maxLength": 40,
"description": "Your own first name, e.g. 'Lloyd'"
}
},
"additionalProperties": false
}Create your own Dial account. Use an email inbox you can read: a confirmation link is sent there and must be opened before you can get a number. Returns your api_key ONCE. Store it somewhere permanent and pass it to the other tools.
| Argument | Type | Description |
|---|---|---|
| email* | string | An email address you can read |
| invite_code | string | Invite code (required during the private beta) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"description": "An email address you can read"
},
"invite_code": {
"type": "string",
"description": "Invite code (required during the private beta)"
}
},
"additionalProperties": false
}Get a Stripe Checkout link for a monthly plan. starter is $15 (1 number, 100 call minutes, 400 SMS), pro is $49 (5 numbers, 250 minutes, 1,000 SMS), scale is $179 (20 numbers, 1,000 minutes, 5,000 SMS). Your human can enter a promotion code on the page. Extra minutes are $0.15, extra numbers $2, extra SMS $0.015. Give the link to your human.
| Argument | Type | Description |
|---|---|---|
| plan | string | starter ($15), pro ($49) or scale ($179). Default starter. |
| api_key* | string | Your Dial API key (from sign_up) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key"
],
"properties": {
"plan": {
"enum": [
"starter",
"pro",
"scale"
],
"type": "string",
"description": "starter ($15), pro ($49) or scale ($179). Default starter."
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
}
},
"additionalProperties": false
}Wait for a verification code (OTP) texted to one of your numbers and return it. Call this right after a site says it sent you a code. Each code is returned once.
| Argument | Type | Description |
|---|---|---|
| api_key* | string | Your Dial API key (from sign_up) |
| service | string | Only accept codes from this sender, e.g. 'google' |
| number_id* | string | id from get_phone_number |
| timeout_seconds | integer | Default 60 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"number_id"
],
"properties": {
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"service": {
"type": "string",
"description": "Only accept codes from this sender, e.g. 'google'"
},
"number_id": {
"type": "string",
"description": "id from get_phone_number"
},
"timeout_seconds": {
"type": "integer",
"maximum": 120,
"minimum": 1,
"description": "Default 60"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
| on_behalf_of* | string | Your human's name, e.g. 'Berk Cagatay' |
| assistant_name | string | Your own first name; the call opens 'Hi, this is <name>, an AI assistant calling for <human>' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_key",
"number_id",
"to",
"goal",
"on_behalf_of"
],
"properties": {
"to": {
"type": "string",
"description": "Number to call, e.g. +13105551234"
},
"goal": {
"type": "string",
"description": "What the call should achieve, e.g. 'Book a table for 2 this Saturday at 7pm'"
},
"voice": {
"type": "string",
"description": "Voice persona from list_voices, e.g. 'brian' (calm male) or 'sarah' (warm female). 'male'/'female' also work."
},
"api_key": {
"type": "string",
"minLength": 10,
"description": "Your Dial API key (from sign_up)"
},
"details": {
"type": "string",
"description": "Facts the assistant may share: reservation name, party size, a callback number, preferences"
},
"number_id": {
"type": "string",
"description": "id of your number (from get_phone_number); the call comes from it"
},
"may_agree_to": {
"type": "string",
"description": "Limits, e.g. 'any time 6:30-8:30pm; no deposit'. Without this it agrees only to exactly the goal."
},
"on_behalf_of": {
"type": "string",
"description": "Your human's name, e.g. 'Berk Cagatay'"
},
"assistant_name": {
"type": "string",
"description": "Your own first name; the call opens 'Hi, this is <name>, an AI assistant calling for <human>'"
}
},
"additionalProperties": false
}