AgentPhone MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with AgentPhone MCP or direct API to send messages, make voice calls, manage contacts, and monitor conversations through natural language.

AgentPhone logoAgentPhone
Api Key

AgentPhone is a communications platform for AI-powered phone numbers, voice calls, messaging, and WhatsApp. It helps you manage agent conversations, contacts, webhooks, and usage from one place.

76 Tools

Try AgentPhone now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
AgentPhone
Try asking
TOOLS

Supported Tools

Every AgentPhone action and event your agent gets out of the box.

Check Verification

Check a recipient-provided six-digit code against a pending verification.

Complete WhatsApp Connection

Complete Meta Embedded Signup using a caller-supplied short-lived code.

Configure Webhook

Create or update the account webhook or one agent override.

Connect WhatsApp Number

Register one existing WABA phone number for Meta Cloud API use and bind it to AgentPhone, optionally attaching an agent.

Create Agent

Create a webhook-mode or hosted AI voice agent.

Create Contact

Create an AgentPhone contact from a phone number and name.

Create SIP Trunk

Create a SIP trunk with provider-generated routing.

Create Sub-Account

Create an AgentPhone sub-account with the supplied name.

Create Web Call

Create a browser-call session and return a secret access token that expires in 30 seconds.

Create WhatsApp Template

Submit either authored components or one Meta Template Library entry to a connected WABA.

Delete Agent

Permanently delete an AgentPhone agent.

Delete Contact

Permanently delete one saved AgentPhone contact.

Delete Contact Card

Permanently remove the recipient-visible iMessage contact card from an owned AgentPhone number.

Delete SIP Trunk

Permanently delete a SIP trunk, remove its upstream routing, and soft-delete its local record.

Delete Sub-Account

Permanently delete an AgentPhone sub-account and all isolated tenant state associated with it.

Delete Webhook

Delete the account webhook and stop account delivery, or delete an agent override so that agent falls back to the account webhook.

Delete WhatsApp Template

Permanently delete a Meta WhatsApp template.

Disconnect Supabase

Permanently disconnect the AgentPhone account's existing Supabase integration.

Disconnect WhatsApp

Permanently disconnect a WhatsApp Business Account from AgentPhone and release its AgentPhone numbers.

Download Call Recording

Download the complete WAV recording for a completed AgentPhone call as a file.

End Call

Immediately request termination of an active AgentPhone call.

Get Agent

Get one AgentPhone agent by ID with its voice configuration and attached numbers.

Get Call

Get full status, timing, metadata, and transcript details for one AgentPhone call by ID.

Get Call Transcript

Read the complete stored transcript for a completed or in-progress call.

Get Call Transcript Events

Download up to 1 MB of SSE events for a completed AgentPhone call as a file.

Get Contact

Get one saved AgentPhone contact by its stable contact ID.

Get Contact Capabilities

Run a live check, without sending a message, for the current iMessage, SMS, and RCS reachability of a phone number.

Get Contact Card

Get the recipient-visible iMessage contact card currently configured for one owned AgentPhone number.

Get Conversation

Get one conversation by ID with participants, channel state, capabilities, and up to 100 recent messages.

Get Location

Get the provider's current latitude, longitude, status, and last-update timestamp for one known phone number.

Get Number

Get one owned AgentPhone number by ID, including active or released records, with its status and channel configuration.

Get Registration Details

Read submitted A2P 10DLC brand and campaign content exactly as exposed for review.

Get Registration Status

Read the current A2P 10DLC campaign status, processing stage, provider message, and resolved sub-account.

Get SIP Trunk

Get one SIP trunk by ID with routing, transfer, encryption, URI, and allowed-IP settings.

Get Supabase Status

Check whether the AgentPhone account has an authenticated Supabase integration and return non-secret project or account metadata.

Get Usage

Get current account quotas, reporting-period bounds, and message, call, SMS segment, and webhook activity totals and rolling windows.

Get Usage Breakdown

Break down usage by owned phone number or by agent.

Get Usage Trends

Get message, call, and webhook usage as either daily or monthly time-series points.

Get Webhook

Get the account webhook or one agent's override without exposing its signing secret.

Get Webhook Delivery Stats

Get detailed recent webhook delivery health or lightweight all-time aggregate counts.

Get WhatsApp Status

Inspect whether WhatsApp is enabled and connected and return the account's AgentPhone WhatsApp connection IDs.

List Agents

List AI voice agents and their current voice, mode, configuration, and attached numbers.

List Calls

List calls account-wide, for one agent, or for one owned number.

List Contacts

Search and list saved contacts used in messaging workflows.

List Conversations

List account-wide or agent-scoped messaging conversations with participants, channels, latest activity, and message counts.

List Messages

Read one newest-first page of message history for either a conversation or an owned phone number.

List Numbers

List owned AgentPhone numbers with routing, agent assignment, SMS registration, and channel status.

List SIP Trunks

List SIP trunks and their routing, transfer, encryption, URI, and IP configuration.

List Sub-Accounts

List isolated sub-accounts with optional recent activity statistics.

List Voices

List a bounded prefix of voice IDs and metadata available for hosted AgentPhone agents.

List Webhook Deliveries

List one page of account-wide deliveries or the bounded recent deliveries for one agent.

List WhatsApp Numbers

List phone numbers available on a connected WhatsApp Business Account and show which are already connected to AgentPhone.

List WhatsApp Templates

List and filter a connected WhatsApp Business Account's message templates, including their language variants and Meta approval status.

Lookup Numbers

Look up line type, country, and RCS intelligence before messaging up to 25 phone numbers.

Place Call

Immediately place one externally visible, metered outbound telephone call from an AgentPhone agent to a consented destination.

Provision Number

Purchase and provision an AgentPhone number, optionally choosing an area code and attaching an agent.

Refresh Locations

Request one asynchronous refresh of account location data.

Refresh Supabase Token

Retrieve a valid Supabase credential server-side, refreshing AgentPhone's stored provider credential when needed.

Release Number

PERMANENTLY AND IRREVERSIBLY release an owned AgentPhone number from its upstream provider and mark it released.

Search Available Numbers

Search unreserved US or Canadian phone-number inventory before provisioning a number.

Send Message

Send one externally visible and potentially billed SMS, MMS, iMessage, RCS-routed, or WhatsApp message.

Send Reaction

Send one externally visible iMessage tapback or supported custom emoji reaction to an existing message.

Send Typing Indicator

Show a short-lived, externally visible typing indicator in a one-to-one or group iMessage conversation.

Send Verification

Send an external SMS containing a non-configurable six-digit code that expires after 10 minutes and allows at most three checks.

Set Agent Number Assignment

Attach an owned phone number to an agent or detach it, changing which agent handles that number.

Set Contact Card

Create or fully replace the recipient-visible iMessage contact card for an owned number.

Start Supabase Connection

Create a one-shot, short-lived Supabase OAuth bootstrap and return a secret connect URL.

Submit A2P Registration

Submit legal business, campaign, consent, and sample-message information for external US carrier A2P 10DLC review.

Test Webhook

Send one externally observable fake message payload to the account webhook or an agent override.

Update A2P Registration

Submit selected changes to an existing A2P 10DLC registration for external carrier review.

Update Agent

Update one or more selected fields of an existing voice agent.

Update Chat Background

Set or remove the recipient-visible custom background for an iMessage chat.

Update Contact

Update explicitly supplied fields of an existing AgentPhone contact.

Update Conversation

Replace a conversation's stored agent context and/or rename an iMessage group.

Update SIP Trunk

Update selected display, transfer, or inbound origination settings on an existing SIP trunk.

Update Sub-Account

Rename an existing AgentPhone sub-account.

SETUP GUIDE

Connect AgentPhone MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["agentphone"],
  mcp: true,
});
Create a session scoped to AgentPhone and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Send a text message to +14155550123 saying the appointment is confirmed for tomorrow at 10 AM.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a AgentPhone request
SETUP GUIDE

Connect AgentPhone API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["agentphone"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to AgentPhone
3

Run AgentPhone tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Send a text message to +14155550123 saying the appointment is confirmed for tomorrow at 10 AM." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the AgentPhone tool calls through the session, and print the final answer

Why Use Composio?

AI Native AgentPhone Integration

  • Supports both AgentPhone MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable messaging, calling, and contact tool execution
  • Rich coverage for sending messages, managing conversations, handling webhooks, and checking usage

Managed Auth

  • Securely stores and uses your AgentPhone API key without exposing it to your agent
  • Central place to manage, scope, and revoke AgentPhone access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear inputs help agents send messages, place calls, and query AgentPhone data correctly
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access AgentPhone
  • Scoped, least privilege access to AgentPhone phone numbers, conversations, contacts, and usage data
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use AgentPhone with any AI Agent Framework

Choose a Framework you want to connect AgentPhone with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with AgentPhone.It takes 30 seconds.

Managed auth, hosted MCP servers, and every AgentPhone tool your agent needs.Free to start.

Start building