Phone tools

Every capability is an MCP tool called over the /mcp JSON-RPC endpoint. Call tools/list for the authoritative, always-current schema; the summary below is a guide.

Agents

• create_agent — Create an agent with your own unique id; it gets a dedicated number and is voiced by the server LLM.
• get_agent — Fetch one agent, including whether it is currently running.
• list_agents — List every agent in your account with its number and status.
• pause_agent / resume_agent — Pause or resume an agent. Persisted across restarts; agents also auto-stop after 30 days.

Calls & messages

• make_call — Place a call from an agent’s number, described by a task. The server runs the whole conversation and returns the transcript.
• get_call — Read a call’s status, duration, and transcript.
• list_transcripts — Return an agent’s past calls.
• new_calls / new_messages — Return inbound calls and SMS received since your last check.

Contacts

• add_contact — Save a person (name, number, description) so the agent greets them by name on calls to and from that number.
• list_contacts / remove_contact — Manage saved contacts.

Numbers & credits

• list_numbers — List the numbers your account owns.
• list_countries — Countries your Twilio account can buy numbers in.
• list_voices — The TTS voice catalog for voiceId.

Calls, messages, and agent creation consume workspace credits.