Permite que los agentes de IA realicen llamadas telefónicas salientes en EE. UU., naveguen por menús, esperen en línea y obtengan transcripciones de las llamadas.
También conocido como ClawCall-Dev/clawcall, @clawcall/mcp
- Stars
- 10
- Herramientas
- —
- Descargas, 30 días
- 195
- Última versión
- 0.2.0
- Último commit
- 13 oct 2026
- Licencia
- MIT
¿Qué es ClawCall MCP?
ClawCall es un MCP server. Permite que los agentes de IA realicen llamadas telefónicas salientes en EE. UU., naveguen por menús, esperen en línea y obtengan transcripciones de las llamadas.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ClawCall
Clawcall ofrece una forma para que los agentes de IA inicien llamadas telefónicas salientes dentro de los Estados Unidos. Este MCP server vía stdio actúa como una capa de conectividad para la API REST de ClawCall, permitiendo que hosts como Claude Desktop, Cursor o Windsurf interactúen con la red telefónica. Está diseñado para desarrolladores que buscan integrar la comunicación por voz en sus flujos de trabajo de agentes, habilitando tareas como navegar por menús telefónicos o esperar en línea.
Los usuarios pueden configurar el servidor usando npx sin necesidad de una API key inicial, ya que el sistema auto-provisiona una proto-key durante el primer comando place_call. Esta clave y el número de teléfono del usuario se almacenan en un archivo de configuración local para mantener una identidad consistente, la cuota de prueba y el historial de llamadas. Aunque el servidor admite una variable de entorno opcional CLAWCALL_API_KEY para sobrescribir valores, se basa principalmente en esta persistencia local para gestionar el estado de la cuenta.
El servidor ofrece diferentes patrones de interacción a través de herramientas específicas. La herramienta place_call_and_wait proporciona un acceso directo para llamadas individuales mediante sondeo (polling) hasta que el ciclo de vida se finaliza, con un límite de 240 segundos. Para tareas más complejas, como campañas de recolección de información, los desarrolladores pueden usar las herramientas no bloqueantes place_call y get_call para gestionar múltiples llamadas en paralelo.
Qué puedes hacer con él
- 1Ejecutar llamadas salientes individualesUn agente de IA puede realizar una única llamada telefónica y esperar a que el resultado se finalice antes de continuar.
- 2Ejecutar campañas de recolección de informaciónUn desarrollador puede instruir a un agente para que realice múltiples llamadas en paralelo para obtener cotizaciones o verificar inventario.
- 3Analizar resultados de llamadas mediante transcripcionesDespués de que termina una llamada, el agente puede recuperar la transcripción de texto para evaluar si la tarea específica fue exitosa.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ClawCall MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ClawCall MCP en Claude Code
$ claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcpInstalar ClawCall MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instalar ClawCall MCP en VS Code
.vscode/mcp.json
{
"servers": {
"clawcall": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instalar ClawCall MCP en VS Code CLI
$ code --add-mcp '{"name":"clawcall","type":"stdio","command":"npx","args":["-y","@clawcall/mcp"],"env":{"CLAWCALL_API_KEY":"<YOUR_CLAWCALL_API_KEY>"}}'Instalar ClawCall MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Instalar ClawCall MCP en Codex
$ codex mcp add clawcall --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' -- npx -y @clawcall/mcpInstalar ClawCall MCP en 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>"
Instalar ClawCall MCP en Gemini CLI
$ gemini mcp add -s user -e 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall npx -- -y @clawcall/mcpInstalar ClawCall MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"clawcall": {
"command": "npx",
"args": [
"-y",
"@clawcall/mcp"
],
"env": {
"CLAWCALL_API_KEY": "<YOUR_CLAWCALL_API_KEY>"
}
}
}
}Configuración
CLAWCALL_API_KEYSecretoOptional 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.
| Nombre | Descripción | Tipo |
|---|---|---|
| CLAWCALL_API_KEY | Optional ClawCall API key (clawcall_sk_...). Auto-provisioned on the first call if unset; shadows the saved key file when present. | Secreto |
| CLAWCALL_BASE_URL | ClawCall REST API base URL. Defaults to https://api.clawcall.dev. |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleclawcall-dev/clawcall is public and reachablegithub.com/clawcall-dev/clawcall ↗Aprobado
- El paquete indica este repositorio como su origen@clawcall/mcp names clawcall-dev/clawcall as sourcenpmjs.com/package/@clawcall/mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-13github.com/clawcall-dev/clawcall ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @clawcall/mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en 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).
Preguntas sobre ClawCall MCP
¿Cómo agrego ClawCall MCP a Claude Code?
Ejecuta claude mcp add --env 'CLAWCALL_API_KEY=<YOUR_CLAWCALL_API_KEY>' clawcall -- npx -y @clawcall/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ClawCall MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Necesito una API key para empezar a usar ClawCall?
No, el servidor puede auto-provisionar una API key. Una llamada anónima generará automáticamente una proto-key que el servidor capturará y guardará.
¿Puedo realizar múltiples llamadas a la vez?
Sí, puedes usar un enfoque de distribución (fan-out) con place_call y get_call para campañas de recolección de información en paralelo, pero debes evitar paralelizar llamadas que impliquen reservas, compras o cancelaciones.
¿Cómo obtengo la transcripción de una llamada?
Puedes usar la herramienta get_call_transcript para leer la transcripción una vez que la llamada haya finalizado.