ADK 向け AgentPhone MCP ツール¶

ADK でサポートPythonTypeScript

AgentPhone MCP Server は、 ADK エージェントを AgentPhone に接続します。 AgentPhone は AI エージェント向けの通信プラットフォームで、電話の発信と着信、 SMS の送受信、電話番号の管理、自然言語で動作する自律型 AI 音声エージェントの作成を支援します。

ユースケース¶

自律的な電話発信: エージェントが電話番号に発信し、指定したトピックについて AI を使った会話を最後まで進め、完了時に完全な書き起こしを返します。
SMS メッセージング: テキストメッセージの送受信、複数の電話番号にまたがる会話スレッドの管理、メッセージ履歴の取得を行います。
電話番号管理: 特定の市外局番付き番号をプロビジョニングし、エージェントに割り当てたり、不要になったら解放したりします。
AI 音声エージェント: Webhook を使わずに、受信・発信の通話を自律的に処理する、音声とシステムプロンプトを柔軟に設定できるエージェントを作成します。
Webhook 連携: プロジェクト単位またはエージェント単位の Webhook を設定して、受信メッセージや通話イベントのリアルタイム通知を受け取ります。

前提条件¶

AgentPhone アカウントを作成します。
AgentPhone 設定から API キーを生成します。

エージェントと一緒に使う¶

PythonTypeScript

Local MCP ServerRemote MCP Server

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="agentphone_agent",
    instruction="Help users make phone calls, send SMS, and manage phone numbers",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "agentphone-mcp",
                    ],
                    env={
                        "AGENTPHONE_API_KEY": AGENTPHONE_API_KEY,
                    }
                ),
                timeout=30,
            ),
        )
    ],
)

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="agentphone_agent",
    instruction="Help users make phone calls, send SMS, and manage phone numbers",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.agentphone.to/mcp",
                headers={
                    "Authorization": f"Bearer {AGENTPHONE_API_KEY}",
                },
            ),
        )
    ],
)

Local MCP ServerRemote MCP Server

import { LlmAgent, MCPToolset } from "@google/adk";

const AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "agentphone_agent",
    instruction: "Help users make phone calls, send SMS, and manage phone numbers",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: ["-y", "agentphone-mcp"],
                env: {
                    AGENTPHONE_API_KEY: AGENTPHONE_API_KEY,
                },
            },
        }),
    ],
});

export { rootAgent };

import { LlmAgent, MCPToolset } from "@google/adk";

const AGENTPHONE_API_KEY = "YOUR_AGENTPHONE_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "agentphone_agent",
    instruction: "Help users make phone calls, send SMS, and manage phone numbers",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.agentphone.to/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        Authorization: `Bearer ${AGENTPHONE_API_KEY}`,
                    },
                },
            },
        }),
    ],
});

export { rootAgent };

利用可能なツール¶

アカウント¶

ツール	説明
`account_overview`	アカウント全体のスナップショット: エージェント、番号、Webhook 状態、利用上限
`get_usage`	詳細な利用状況: プラン上限、番号クォータ、メッセージ/通話量

電話番号¶

ツール	説明
`list_numbers`	アカウント内の全電話番号を一覧表示
`buy_number`	国や市外局番を指定して新しい電話番号を購入

SMS / メッセージ¶

ツール	説明
`send_message`	エージェントの電話番号から SMS または iMessage を送信
`get_messages`	特定の電話番号の SMS メッセージを取得
`list_conversations`	エージェントで絞り込み可能な SMS 会話スレッドを一覧表示
`get_conversation`	完全なメッセージ履歴を含む会話を取得
`update_conversation`	会話のメタデータを設定または解除

音声通話¶

ツール	説明
`list_calls`	エージェント、番号、状態、方向で絞り込み可能な最近の通話を一覧表示
`get_call`	オプションの長時間ポーリング付きで通話詳細と書き起こしを取得
`make_call`	Webhook を使って会話処理のための発信通話を開始
`make_conversation_call`	完全な書き起こしを返す自律型 AI 通話を開始

エージェント¶

ツール	説明
`list_agents`	電話番号と音声設定を含む全エージェントを一覧表示
`create_agent`	設定可能な音声とシステムプロンプトで新しいエージェントを作成
`update_agent`	エージェント設定を更新
`delete_agent`	エージェントを削除
`get_agent`	番号と音声設定を含むエージェント詳細を取得
`attach_number`	電話番号をエージェントに割り当て
`detach_number`	電話番号をエージェントから切り離す
`list_voices`	利用可能な音声オプションを一覧表示

Webhook¶

すべての Webhook ツールは任意の agent_id パラメータを受け取ります。指定するとそのエージェントの Webhook を対象にし、省略するとプロジェクト既定の Webhook を対象にします。エージェントレベルの Webhook はプロジェクトレベルより優先されます。

ツール	説明
`get_webhook`	Webhook 設定を取得
`set_webhook`	受信メッセージと通話イベント用の Webhook URL を設定
`delete_webhook`	Webhook を削除
`test_webhook`	テストイベントを送信して Webhook の動作を確認
`list_webhook_deliveries`	最近の Webhook 配信履歴を表示

構成¶

AgentPhone MCP Server は環境変数で構成できます。

環境変数	説明	デフォルト
`AGENTPHONE_API_KEY`	AgentPhone API キー	必須 (stdio モード)
`AGENTPHONE_BASE_URL`	API ベース URL を上書き	`https://api.agentphone.to`

リモート HTTP モードでは、環境変数ではなく Authorization: Bearer ヘッダーで API キーを渡します。