AIエージェントによる米国内への発信、メニュー操作、保留待機、および通話内容の書き起こし取得を可能にします。
別名 ClawCall-Dev/clawcall, @clawcall/mcp
- スター
- 10
- ツール
- —
- ダウンロード数(30日間)
- 195
- 最新バージョン
- 0.2.0
- 最終コミット
- 2026年10月13日
- ライセンス
- MIT
ClawCall MCPとは
ClawCallはMCPサーバーです。 AIエージェントによる米国内への発信、メニュー操作、保留待機、および通話内容の書き起こし取得を可能にします。.
プロジェクトのREADMEから生成された概要
ClawCall MCP server について
Clawcallは、AIエージェントが米国内へ電話を発信するための手段を提供します。このstdio MCP serverはClawCall REST APIの接続レイヤーとして機能し、Claude Desktop、Cursor、Windsurfなどのホストが電話ネットワークとやり取りできるようにします。音声通信をエージェントのワークフローに統合したい開発者向けに設計されており、電話メニューの操作や保留待機などのタスクを実行できます。
ユーザーはnpxを使用してサーバーをセットアップでき、初期のAPIキーは不要です。最初のplace_callコマンド実行時に、システムがプロトタイプキーを自動的にプロビジョニングします。このキーとユーザーの電話番号はローカルの構成ファイルに保存され、一貫したアイデンティティ、試用枠、および通話履歴が維持されます。サーバーは上書き用のオプションとしてCLAWCALL_API_KEY環境変数もサポートしていますが、主にこのローカルの永続化を利用してアカウント状態を管理します。
サーバーは、特定のツールを通じて異なるインタラクションパターンを提供します。place_call_and_waitツールは、通話のライフサイクルが終了するまで(最大240秒まで)ポーリングを行う単一通話用のショートカットを提供します。情報収集キャンペーンのようなより複雑なタスクの場合、開発者は非ブロッキングのplace_callおよびget_callツールを使用して、複数の並列通話を管理できます。
できること
- 1単発の発信を実行AIエージェントが単一の電話をかけ、結果が確定するまで待機してから次の処理に進むことができます。
- 2情報収集キャンペーンの実行開発者はエージェントに対し、見積もり取得や在庫確認のために複数の並列通話を行うよう指示できます。
- 3書き起こしによる通話結果の分析通話終了後、エージェントはテキストの書き起こしを取得し、特定のタスクが成功したかどうかを評価できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ClawCall MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにClawCall MCPをインストール
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpCursorにClawCall MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}VS CodeにClawCall MCPをインストール
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}VS Code CLIにClawCall MCPをインストール
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'Claude DesktopにClawCall MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}CodexにClawCall MCPをインストール
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpCodex config.tomlにClawCall MCPをインストール
~/.codex/config.toml
[mcp_servers.clawcall] command = "npx" args = ["-y", "@clawcall/mcp"] [mcp_servers.clawcall.env] CLAWCALL_API_KEY = "<YOUR_CLAWCALL_API_KEY>"
Gemini CLIにClawCall MCPをインストール
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpGemini settings.jsonにClawCall MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}設定
CLAWCALL_API_KEYシークレットOptional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present.
CLAWCALL_BASE_URLClawCall REST API base URL. Defaults to https://api.clawcall.dev.
| 名前 | 説明 | 種類 |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | シークレット |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能clawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗合格
- パッケージがこのリポジトリをソースとして指定@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @clawcall/mcp合格
- パッケージおよびその依存関係に重大な勧告なし99 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見る@clawcall/mcp
[!IMPORTANT] Legacy local transport. New integrations should use ClawCall's hosted OAuth MCP connector at
https://api.clawcall.dev/mcp. This stdio package remains available for existing local/API-key installations, but it is not the connector submitted to the official xAI marketplace.
MCP server wrapping the ClawCall REST API for AI-powered US phone calls.
ClawCall places real outbound phone calls in the US (+1 only). This package is a stdio
MCP server that exposes the ClawCall REST contract as tools any MCP host (Claude Code,
Claude Desktop, Cursor, Windsurf) can call. It is a stateless client over the public API
at https://api.clawcall.dev — it imports nothing from the ClawCall server.
Install / register
Add the server to your MCP client config:
{ "mcpServers": { "clawcall": { "command": "npx", "args": ["-y", "@clawcall/mcp"], "env": { "CLAWCALL_API_KEY": "optional", "CLAWCALL_BASE_URL": "https://api.clawcall.dev" } } } }
Or, for Claude Code, the one-liner:
claude mcp add clawcall -- npx -y @clawcall/mcp
The env block is optional. The ClawCall server self-provisions an API key on the
first call: an anonymous place_call auto-issues a proto-key, which this server captures
and persists. You do not need to set CLAWCALL_API_KEY to get started.
Identity sharing
This MCP server reads and writes the same ~/.config/clawcall/key.json file
({ "api_key": "...", "user_phone_number": "..." }) that the ClawCall agent skill uses.
Running both the skill and this MCP server does not fork your identity — they share one
key, one trial quota, one call history, and one balance.
If CLAWCALL_API_KEY is set in the environment, it shadows the file (an operator /
CI override). The saved file is otherwise the source of truth, and the proto-key issued on
your first call is persisted there automatically (preserving any saved user_phone_number).
The workflow
A call runs for several minutes. The load-bearing loop is:
place_call— returns acall_idimmediately. Does not block.- Poll
get_callevery 3 seconds untillifecycle === "finalized". outcomeis the phone-network result (answered / no_answer / busy / …), NOT task success. An answered call can still fail the task.- Read the transcript with
get_call_transcriptand judge it against the task you set.
Choosing a tool
place_call_and_waitis the single-foreground-call shortcut: it places the call and internally polls until finalized or a hard cap (~180 s, ceiling 240 s). On the cap it degrades to the non-blocking contract — it returns{ still_running: true, call_id, … }and you continue withget_call. Use it when you want one call's result in one shot.- Campaigns — 3–4 parallel, interchangeable, info-gathering-only calls (quotes,
availability, inventory, policy comparison) — use
place_call+get_callfan-out. Never use the blocking tool for campaigns. Never parallelize calls that book / buy / cancel / commit.
Caveats
greetingdoes NOT set the agent's first spoken line. It is outbound-opener context only. The agent's actual opening line is a hardcoded recording disclosure on the server.- 402 errors are PERMANENT gating, not retryable.
trial_exhausted,plan_required, andreserved_number_requiredmean a human must act. Forward the returnedaction.url/sign_in_urlverbatim (they are personalized and embed your proto-key). Do not retry.
Trial limits are read from the live quota object in the error envelope — they are
never hardcoded in this package, so the displayed numbers always match the server.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
CLAWCALL_BASE_URL |
https://api.clawcall.dev |
ClawCall REST API base URL. |
CLAWCALL_FRONTEND_URL |
https://clawcall.dev |
Frontend base used to build sign-in / account-link URLs. |
CLAWCALL_API_KEY |
(unset) | Optional operator override. Shadows the saved key file. |
CLAWCALL_WAIT_DEFAULT |
180 |
Default cap (seconds) for place_call_and_wait. |
CLAWCALL_WAIT_CEILING |
240 |
Maximum allowed cap (seconds) for place_call_and_wait. |
More
skill-companion/MCP-COMPANION.md— companion note for the ClawCall skill describing how the two share identity and workflow.../skill/SKILL.md— the ClawCall agent skill (the procedural layer; this MCP server is the connectivity layer over the same REST API).
ClawCall MCPのよくある質問
ClawCall MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ClawCall MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ClawCallの使用を開始するにはAPIキーが必要ですか?
いいえ、サーバーがAPIキーを自動的にプロビジョニングできます。匿名通話時にプロトタイプキーが自動発行され、サーバーがそれを取得して保存します。
一度に複数の電話をかけることはできますか?
はい、place_callとget_callを組み合わせたファンアウト方式を使用して、並列で情報収集キャンペーンを行うことができます。ただし、予約、購入、キャンセルを伴う通話を並列で行うことは避けてください。
通話の書き起こしを取得するにはどうすればよいですか?
通話が終了した後、get_call_transcriptツールを使用して書き起こしを読み取ることができます。