Permet aux agents IA de passer des appels téléphoniques sortants aux États-Unis, de naviguer dans les menus, de patienter en attente et de récupérer les transcriptions d'appels.
Aussi connu sous ClawCall-Dev/clawcall, @clawcall/mcp
- Étoiles
- 10
- Outils
- —
- Téléchargements, 30 jours
- 195
- Dernière version
- 0.2.0
- Dernier commit
- 13 oct. 2026
- Licence
- MIT
Qu'est-ce que ClawCall MCP ?
ClawCall est un serveur MCP. Permet aux agents IA de passer des appels téléphoniques sortants aux États-Unis, de naviguer dans les menus, de patienter en attente et de récupérer les transcriptions d'appels.
Résumé généré à partir du README du projet
À propos du MCP server ClawCall
Clawcall offre aux agents IA la possibilité d'initier des appels téléphoniques sortants aux États-Unis. Ce MCP server via stdio agit comme une couche de connectivité pour l'API REST ClawCall, permettant à des hôtes tels que Claude Desktop, Cursor ou Windsurf d'interagir avec le réseau téléphonique. Il est conçu pour les développeurs souhaitant intégrer la communication vocale dans leurs workflows agentiques, facilitant des tâches comme la navigation dans les menus téléphoniques ou l'attente en ligne.
Les utilisateurs peuvent configurer le serveur via npx sans avoir besoin d'une clé API initiale, car le système auto-provisionne une proto-key lors de la première commande place_call. Cette clé ainsi que le numéro de téléphone de l'utilisateur sont stockés dans un fichier de configuration local afin de maintenir une identité cohérente, un quota d'essai et un historique des appels. Bien que le serveur prenne en charge une variable d'environnement optionnelle CLAWCALL_API_KEY pour les remplacements, il repose principalement sur cette persistance locale pour gérer l'état du compte.
Le serveur propose différents modèles d'interaction via des outils spécifiques. L'outil place_call_and_wait offre un raccourci pour les appels uniques en effectuant un polling jusqu'à la finalisation du cycle de vie, avec un plafond de 240 secondes. Pour des tâches plus complexes, comme des campagnes de collecte d'informations, les développeurs peuvent utiliser les outils non bloquants place_call et get_call pour gérer plusieurs appels en parallèle.
Ce que vous pouvez faire avec
- 1Exécuter des appels sortants uniquesUn agent IA peut passer un appel téléphonique unique et attendre que le résultat soit finalisé avant de poursuivre.
- 2Lancer des campagnes de collecte d'informationsUn développeur peut ordonner à un agent d'effectuer plusieurs appels en parallèle pour recueillir des devis ou vérifier des stocks.
- 3Analyser les résultats des appels via les transcriptionsUne fois l'appel terminé, l'agent peut récupérer la transcription textuelle pour évaluer si la tâche spécifique a été accomplie avec succès.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer ClawCall MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller ClawCall MCP dans Claude Code
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpInstaller ClawCall MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Installer ClawCall MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Installer ClawCall MCP dans VS Code CLI
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'Installer ClawCall MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Installer ClawCall MCP dans Codex
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpInstaller ClawCall MCP dans 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>"
Installer ClawCall MCP dans Gemini CLI
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpInstaller ClawCall MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Configuration
CLAWCALL_API_KEYSecretOptional 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.
| Nom | Description | Type |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | Secret |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleclawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗Réussi
- Le nom du package correspond au dépôt source@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @clawcall/mcpRéussi
- Aucun avis critique dans le package ou ses dépendances99 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur 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).
Questions sur ClawCall MCP
Comment ajouter ClawCall MCP à Claude Code ?
Exécutez claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter ClawCall MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Ai-je besoin d'une clé API pour commencer à utiliser ClawCall ?
Non, le serveur peut auto-provisionner une clé API. Un appel anonyme générera automatiquement une proto-key que le serveur capturera et conservera.
Puis-je passer plusieurs appels simultanément ?
Oui, vous pouvez utiliser une approche de type fan-out avec place_call et get_call pour des campagnes de collecte d'informations en parallèle, mais vous devriez éviter de paralléliser des appels impliquant des réservations, des achats ou des annulations.
Comment obtenir la transcription d'un appel ?
Vous pouvez utiliser l'outil get_call_transcript pour lire la transcription une fois l'appel terminé.