clawcall

@clawcall/mcp

重要

レガシーのローカルトランスポートです。 新しいインテグレーションでは、ClawCall のホスト型 OAuth MCP コネクター https://api.clawcall.dev/mcp を使用してください。この stdio パッケージは、既存のローカル／API キー構成向けに引き続き利用できますが、公式 xAI マーケットプレイスに申請されたコネクターではありません。

AI を活用した米国向け電話発信を行う ClawCall REST API をラップする MCP サーバーです。

ClawCall は、米国内（+1 のみ）に実際の電話を発信します。このパッケージは、ClawCall REST のコントラクトを、あらゆる MCP ホスト（Claude Code、 Claude Desktop、Cursor、Windsurf）から呼び出せるツールとして公開する stdio MCP サーバーです。公開 API https://api.clawcall.dev を利用するステートレスなクライアントであり、ClawCall サーバーから何もインポートしません。

インストール／登録

MCP クライアントの設定にサーバーを追加します。

{ "mcpServers": { "clawcall": { "command": "npx", "args": ["-y", "@clawcall/mcp"], "env": { "CLAWCALL_API_KEY": "optional", "CLAWCALL_BASE_URL": "https://api.clawcall.dev" } } } }

または、Claude Code の場合は次のワンライナーを使用します。

claude mcp add clawcall -- npx -y @clawcall/mcp

env ブロックは省略可能です。ClawCall サーバーは、最初の呼び出し時に API キーを自動でプロビジョニングします。匿名の place_call により proto-key が自動発行され、このサーバーがそれを取得して保存します。利用を始めるにあたり、CLAWCALL_API_KEY を設定する必要はありません。

ID の共有

この MCP サーバーは、ClawCall エージェントスキルと同じ ~/.config/clawcall/key.json ファイル （{ "api_key": "...", "user_phone_number": "..." }）を読み書きします。 スキルとこの MCP サーバーを両方実行しても、ID が分かれることはありません。1 つのキー、1 つのトライアル枠、1 つの通話履歴、1 つの残高を共有します。

環境変数に CLAWCALL_API_KEY が設定されている場合、ファイルの内容よりも優先されます（運用担当者／ CI による上書き）。それ以外の場合は保存済みファイルが正とされ、最初の通話で発行された proto-key は（保存済みの user_phone_number を保持したまま）自動的にそこへ保存されます。

ワークフロー

通話には数分かかります。重要な処理の流れは次のとおりです。

1. place_call — 直ちに call_id を返します。ブロックしません。
2. lifecycle === "finalized" になるまで、3 秒ごとに get_call をポーリングします。
3. outcome は電話網の結果（answered / no_answer / busy / …）であり、タスクの成功を示すものではありません。通話に応答があっても、タスクに失敗することがあります。
4. get_call_transcript でトランスクリプトを読み、設定したタスクに照らして判定します。

ツールの選択

• place_call_and_wait は、単一のフォアグラウンド通話向けのショートカットです。通話を発信し、確定するまで内部でポーリングします。ハード上限は約 180 秒（上限 240 秒）です。上限に達すると、非ブロッキングのコントラクトに切り替わり、{ still_running: true, call_id, … } を返します。その後は get_call を使って処理を続けます。1 回の呼び出しで通話結果を得たい場合に使用してください。
• キャンペーン — 見積もり、空き状況、在庫、ポリシー比較など、情報収集のみを目的とする、相互に置き換え可能な 3～4 件の並列通話には、place_call と get_call によるファンアウトを使用します。キャンペーンでは、ブロッキングツールを絶対に使用しないでください。予約／購入／キャンセル／確約を行う通話を並列化しないでください。

注意事項

• greeting はエージェントの最初の発話を設定しません。 発信時のオープナーのコンテキストとしてのみ使用されます。エージェントが実際に最初に話す内容は、サーバーにハードコードされた録音に関する開示です。
• 402 エラーは再試行できない恒久的な利用制限です。 trial_exhausted、plan_required、reserved_number_required は、人による対応が必要であることを意味します。返された action.url ／ sign_in_url をそのまま転送してください（これらは個別に設定され、proto-key が埋め込まれています）。再試行しないでください。

トライアルの制限は、エラーエンベロープ内のライブな quota オブジェクトから読み取られます。このパッケージにハードコードされることはないため、表示される数値は常にサーバーと一致します。

環境変数

変数	デフォルト値	用途
CLAWCALL_BASE_URL	https://api.clawcall.dev	ClawCall REST API のベース URL です。
CLAWCALL_FRONTEND_URL	https://clawcall.dev	サインイン／アカウント連携 URL の生成に使用するフロントエンドのベース URL です。
CLAWCALL_API_KEY	(unset)	オプションのオペレーターによる上書きです。保存済みのキーのファイルより優先されます。
CLAWCALL_WAIT_DEFAULT	180	place_call_and_wait のデフォルト上限（秒）です。
CLAWCALL_WAIT_CEILING	240	place_call_and_wait で許可される上限（秒）です。

詳細

• skill-companion/MCP-COMPANION.md — ClawCall スキルの補足説明です。2 つがどのように ID とワークフローを共有するかを説明しています。
• ../skill/SKILL.md — ClawCall エージェントスキル（手順レイヤーです。この MCP サーバーは、同じ REST API 上の接続レイヤーです）。