Memungkinkan AI agent untuk melakukan panggilan telepon keluar di Amerika Serikat, menavigasi menu, menunggu antrean (on hold), dan mengambil transkrip panggilan.
Juga dikenal sebagai ClawCall-Dev/clawcall, @clawcall/mcp
- Stars
- 10
- Tools
- —
- Unduhan, 30 hari
- 195
- Versi terbaru
- 0.2.0
- Commit terakhir
- 13 Okt 2026
- Lisensi
- MIT
Apa itu ClawCall MCP?
ClawCall adalah MCP server. Memungkinkan AI agent untuk melakukan panggilan telepon keluar di Amerika Serikat, menavigasi menu, menunggu antrean (on hold), dan mengambil transkrip panggilan.
Ringkasan dibuat dari README proyek
Tentang ClawCall MCP server
Clawcall menyediakan cara bagi AI agent untuk melakukan panggilan telepon keluar di dalam Amerika Serikat. MCP server berbasis stdio ini bertindak sebagai layer konektivitas untuk ClawCall REST API, yang memungkinkan host seperti Claude Desktop, Cursor, atau Windsurf untuk berinteraksi dengan jaringan telepon. Tool ini dirancang bagi developer yang ingin mengintegrasikan komunikasi suara ke dalam workflow agentic mereka, memungkinkan tugas-tugas seperti menavigasi menu telepon atau menunggu antrean.
Pengguna dapat menyiapkan server menggunakan npx tanpa memerlukan API key di awal, karena sistem akan melakukan self-provision proto-key selama perintah place_call pertama dijalankan. Key ini dan nomor telepon pengguna akan disimpan dalam file konfigurasi lokal untuk menjaga konsistensi identitas, kuota trial, dan riwayat panggilan. Meskipun server mendukung environment variable CLAWCALL_API_KEY opsional untuk override, server ini utamanya mengandalkan persistensi lokal tersebut untuk mengelola status akun.
Server ini menawarkan pola interaksi yang berbeda melalui tool spesifik. Tool place_call_and_wait menyediakan jalan pintas untuk panggilan tunggal dengan melakukan polling hingga siklus panggilan selesai, dengan batas maksimal 240 detik. Untuk tugas yang lebih kompleks seperti kampanye pengumpulan informasi, developer dapat menggunakan tool place_call dan get_call yang bersifat non-blocking untuk mengelola banyak panggilan secara paralel.
Apa yang bisa Anda lakukan dengannya
- 1Melakukan panggilan keluar tunggalAI agent dapat melakukan satu panggilan telepon dan menunggu hasilnya selesai sebelum melanjutkan ke langkah berikutnya.
- 2Menjalankan kampanye pengumpulan informasiDeveloper dapat menginstruksikan agent untuk melakukan beberapa panggilan paralel guna mengumpulkan penawaran harga atau mengecek ketersediaan stok.
- 3Menganalisis hasil panggilan melalui transkripSetelah panggilan berakhir, agent dapat mengambil transkrip teks untuk mengevaluasi apakah tugas spesifik tersebut berhasil dilakukan.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal ClawCall MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal ClawCall MCP di Claude Code
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpInstal ClawCall MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instal ClawCall MCP di VS Code
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instal ClawCall MCP di VS Code CLI
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'Instal ClawCall MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instal ClawCall MCP di Codex
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpInstal ClawCall MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.clawcall] command = "npx" args = ["-y", "@clawcall/mcp"] [mcp_servers.clawcall.env] CLAWCALL_API_KEY = "<YOUR_CLAWCALL_API_KEY>"
Instal ClawCall MCP di Gemini CLI
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpInstal ClawCall MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Konfigurasi
CLAWCALL_API_KEYRahasiaOptional 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.
| Nama | Deskripsi | Tipe |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | Rahasia |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauclawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @clawcall/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya99 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di 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).
Pertanyaan tentang ClawCall MCP
Bagaimana cara menambahkan ClawCall MCP ke Claude Code?
Jalankan claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan ClawCall MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah saya memerlukan API key untuk mulai menggunakan ClawCall?
Tidak, server dapat melakukan self-provision untuk API key. Panggilan anonim akan secara otomatis menerbitkan proto-key yang kemudian ditangkap dan disimpan oleh server.
Bisakah saya melakukan beberapa panggilan sekaligus?
Ya, Anda dapat menggunakan pendekatan fan-out dengan place_call dan get_call untuk kampanye pengumpulan informasi secara paralel, namun sebaiknya hindari melakukan paralel pada panggilan yang melibatkan proses booking, pembelian, atau pembatalan.
Bagaimana cara mendapatkan transkrip panggilan?
Anda dapat menggunakan tool get_call_transcript untuk membaca transkrip setelah panggilan selesai dilakukan.