AgentPhone Toolkit

Integrate with the AgentPhone toolkit using LangChain Python.

AgentPhone is a telephony platform for AI agents. The langchain-agentphone package provides LangChain tools for sending messages, making AI-powered phone calls, managing phone numbers, and more.

Overview

Integration details

Class	Package	Serializable	JS support	Version
AgentPhoneToolkit	langchain-agentphone	❌	❌

Available tools

Tool	Description
AgentPhoneSendSMS	Send a text message
AgentPhoneMakeCall	Make an AI-powered outbound phone call
AgentPhoneGetTranscript	Get the transcript of a phone call
AgentPhoneListCalls	List phone calls with optional filters
AgentPhoneListConversations	List conversations
AgentPhoneGetConversation	Get a conversation with its messages
AgentPhoneBuyNumber	Buy a new phone number
AgentPhoneListNumbers	List phone numbers on the account
AgentPhoneCreateAgent	Create a new AI phone agent
AgentPhoneListAgents	List AI phone agents
AgentPhoneCreateContact	Create a new contact
AgentPhoneListContacts	List contacts

Setup

Install the package:

pip install -qU langchain-agentphone

Credentials

You need an AgentPhone API key. Sign up at agentphone.to to get one.

import getpass
import os

if not os.environ.get("AGENTPHONE_API_KEY"):
    os.environ["AGENTPHONE_API_KEY"] = getpass.getpass("AgentPhone API key:\n")

Instantiation

Use the toolkit to get all tools at once, or select specific ones:

from langchain_agentphone import AgentPhoneToolkit

# All tools
toolkit = AgentPhoneToolkit()
tools = toolkit.get_tools()

# Or select specific tools
toolkit = AgentPhoneToolkit(selected_tools=["send_sms", "list_numbers", "make_call"])
tools = toolkit.get_tools()

You can also instantiate individual tools directly:

from langchain_agentphone import AgentPhoneSendSMS, AgentPhoneListNumbers

send_sms = AgentPhoneSendSMS()
list_numbers = AgentPhoneListNumbers()

Invocation

Invoke directly with args

from langchain_agentphone import AgentPhoneSendSMS

tool = AgentPhoneSendSMS()
result = tool.invoke({
    "number_id": "num_abc123",
    "to_number": "[phone]",
    "body": "Hello from LangChain!"
})
print(result)

Invoke with ToolCall

model_generated_tool_call = {
    "args": {
        "number_id": "num_abc123",
        "to_number": "[phone]",
        "body": "Meeting at 3pm confirmed."
    },
    "id": "1",
    "name": "agentphone_send_sms",
    "type": "tool_call",
}
tool_msg = tool.invoke(model_generated_tool_call)
print(tool_msg.content)

Use within an agent

from langchain_agentphone import AgentPhoneToolkit
from langchain.chat_models import init_chat_model
from langgraph.prebuilt import create_react_agent

model = init_chat_model(model="claude-sonnet-4-6", model_provider="anthropic")

toolkit = AgentPhoneToolkit(
    selected_tools=["send_sms", "list_numbers", "list_contacts"]
)
agent = create_react_agent(model, toolkit.get_tools())

response = agent.invoke({
    "messages": [("user", "List my phone numbers, then send a message to [phone] saying 'Hello!'")]
})

---

API reference

For detailed documentation of the AgentPhone API, visit docs.agentphone.to.

---

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.