AI agent'larının ABD içinden dış aramalar yapmasına, menülerde gezinmesine, bekleme sırasında kalmasına ve arama transkriptlerini almasına olanak tanır.
Ayrıca bilinen adı ClawCall-Dev/clawcall, @clawcall/mcp
- Yıldızlar
- 10
- Araçlar
- —
- İndirmeler, 30 gün
- 195
- En son sürüm
- 0.2.0
- Son commit
- 13 Eki 2026
- Lisans
- MIT
ClawCall MCP nedir?
ClawCall bir MCP sunucusudur. AI agent'larının ABD içinden dış aramalar yapmasına, menülerde gezinmesine, bekleme sırasında kalmasına ve arama transkriptlerini almasına olanak tanır.
Özet, projenin README dosyasından oluşturuldu
ClawCall MCP sunucusu hakkında
Clawcall, AI agent'larının Amerika Birleşik Devletleri içinde dış aramalar başlatması için bir yöntem sunar. Bu stdio MCP server, ClawCall REST API için bir bağlantı katmanı görevi görerek Claude Desktop, Cursor veya Windsurf gibi host'ların telefon ağıyla etkileşime girmesine olanak tanır. Sesli iletişimi agentic iş akışlarına entegre etmek isteyen ve telefon menülerinde gezinme veya bekleme sırasında kalma gibi görevleri gerçekleştirmek isteyen geliştiriciler için tasarlanmıştır.
Kullanıcılar, sistem ilk place_call komutu sırasında bir proto-key'i otomatik olarak tanımladığı için başlangıçta bir API anahtarına ihtiyaç duymadan sunucuyu npx kullanarak kurabilirler. Tutarlı bir kimlik, deneme kotası ve arama geçmişi sağlamak amacıyla bu anahtar ve kullanıcının telefon numarası yerel bir yapılandırma dosyasında saklanır. Sunucu, geçersiz kılmalar için isteğe bağlı bir CLAWCALL_API_KEY ortam değişkenini desteklese de, hesap durumunu yönetmek için öncelikle bu yerel kalıcılığa güvenir.
Sunucu, belirli araçlar aracılığıyla farklı etkileşim modelleri sunar. place_call_and_wait aracı, yaşam döngüsü tamamlanana kadar (240 saniye üst sınırla) sorgulama yaparak tekli aramalar için bir kısayol sağlar. Bilgi toplama kampanyaları gibi daha karmaşık görevler için geliştiriciler, birden fazla paralel aramayı yönetmek amacıyla bloklamayan place_call ve get_call araçlarını kullanabilirler.
Neler yapabilirsiniz
- 1Tekli dış aramalar gerçekleştirinBir AI agent, tek bir telefon araması yapabilir ve devam etmeden önce sonucun tamamlanmasını bekleyebilir.
- 2Bilgi toplama kampanyaları yürütünBir geliştirici, fiyat teklifi toplamak veya stok kontrolü yapmak için bir agent'a birden fazla paralel arama yapması talimatını verebilir.
- 3Transkriptler aracılığıyla arama sonuçlarını analiz edinBir arama sona erdikten sonra agent, belirli görevin başarılı olup olmadığını değerlendirmek için metin transkriptini alabilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ClawCall MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleClawCall MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpClawCall MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}ClawCall MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}ClawCall MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'ClawCall MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}ClawCall MCP'yi Codex içine yükleyin
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpClawCall MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.clawcall] command = "npx" args = ["-y", "@clawcall/mcp"] [mcp_servers.clawcall.env] CLAWCALL_API_KEY = "<YOUR_CLAWCALL_API_KEY>"
ClawCall MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpClawCall MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Yapılandırma
CLAWCALL_API_KEYGizliOptional 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.
| Ad | Açıklama | Sunucu |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | Gizli |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirclawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @clawcall/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 401 (sign-in required)Geçti
@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 soruları
ClawCall MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ClawCall MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
ClawCall kullanmaya başlamak için bir API anahtarına ihtiyacım var mı?
Hayır, sunucu kendi kendine bir API anahtarı tanımlayabilir. Anonim bir arama, sunucunun yakalayıp saklayacağı bir proto-key oluşturacaktır.
Aynı anda birden fazla arama yapabilir miyim?
Evet, paralel bilgi toplama kampanyaları için place_call ve get_call ile fan-out yaklaşımını kullanabilirsiniz; ancak rezervasyon, satın alma veya iptal içeren aramaları paralel yürütmekten kaçınmalısınız.
Bir aramanın transkriptini nasıl alabilirim?
Arama tamamlandıktan sonra transkripti okumak için get_call_transcript aracını kullanabilirsiniz.