ClawdCall

Servidor MCP de ClawdCall

Brinda a los agentes de IA acceso a la API de ejecución telefónica orientada a agentes de ClawdCall a través del Protocolo de Contexto de Modelo.

clawdcall-mcp expone el flujo de trabajo confirmado de ClawdCall:

• enviar OTP de registro
• verificar OTP de registro
• realizar llamadas salientes esperadas
• obtener transcripciones de llamadas

Remoto Alojado

Conecta clientes MCP remotos compatibles al endpoint HTTP Streamable:

https://gateway.clawdcall.com/mcp/

El endpoint anuncia metadatos de recursos protegidos por OAuth. Las integraciones existentes de ClawdCall también pueden usar una clave de API según la documentación del agente.

Paquete Stdio Local

Agrega el paquete npm publicado a un cliente MCP local:

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key"
      }
    }
  }
}

CLAWDCALL_API_KEY es necesario para llamadas salientes y recuperación de transcripciones. Las herramientas de OTP de registro no requieren una clave existente.

Para enrutamiento de API de staging o autoalojado:

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key",
        "CLAWDCALL_BASE_URL": "https://api.clawdcall.com"
      }
    }
  }
}

Primera Prueba Segura

1. Abre la configuración del agente de ClawdCall.
2. Conecta el endpoint alojado o el paquete local desde un cliente de agente compatible.
3. Pide al agente que te llame a ti o a un destinatario interno esperado con una tarea acotada.
4. Confirma el destino y la tarea antes de permitir la llamada.
5. Revisa el estado devuelto, la evidencia de la transcripción, el resumen o el resultado estructurado.

ClawdCall no está destinado a llamadas en frío, robocalling, divulgación masiva, uso de emergencia, divulgación política o flujos de trabajo de asesoramiento sensible.

Ejemplos de Copiar y Pegar

El directorio examples contiene flujos de trabajo de primera llamada acotados para:

• Auto-llamada MCP
• SDK de Agentes de OpenAI
• Agentes respaldados por LangGraph
• Alertas firmadas de webhook a llamada

Los ejemplos de código mantienen al destinatario en variables de entorno controladas por el operador. La entrada generada por el agente no puede cambiar el número de teléfono, y los efectos secundarios en vivo requieren una aprobación explícita o aceptación.

Herramientas

Herramienta	Endpoint confirmado	Descripción
send_signup_otp	POST /cc/signup/send-otp	Envía un OTP de verificación telefónica para el registro.
verify_signup_otp	POST /cc/signup/verify-otp	Verifica el OTP y recibe detalles de cuenta/clave de API.
place_outbound_call	POST /external/v1/agent/outbound?conversionFlag=1	Realiza una llamada de agente de voz saliente esperada.
get_call_transcript	GET /cc/v1/calls/{id}/transcript	Obtiene una transcripción por ID de llamada o ID de campaña.

Variables de Entorno

Variable	Requerida	Predeterminada	Descripción
CLAWDCALL_API_KEY	Para herramientas de llamada/transcripción		Clave de API de ClawdCall.
CLAWDCALL_BASE_URL	No	https://api.clawdcall.com	URL base de la API.

Desarrollo

git clone https://github.com/dialgoodian/clawdcall-mcp.git
cd clawdcall-mcp
npm install
npm run dev

Compilar:

npm run build

Ejecutar el servidor compilado:

CLAWDCALL_API_KEY=your_clawdcall_api_key npm start

Metadatos de Descubrimiento

• server.json contiene los metadatos del Registro Oficial de MCP.
• Tarjeta del servidor
• Documentación legible por agentes
• Descripción de OpenAPI

Contrato de API

Este servidor rastrea estos endpoints orientados a agentes de ClawdCall:

• POST /cc/signup/send-otp
• POST /cc/signup/verify-otp
• POST /external/v1/agent/outbound?conversionFlag=1
• GET /cc/v1/calls/{id}/transcript

No agregues herramientas MCP para agentes, compra de números, SMS, conversaciones, voces o webhooks generales hasta que esas rutas existan en el contrato de API de ClawdCall.

Licencia

MIT