ClawdCall

Dê aos agentes de IA uma camada telefônica para chamadas baseadas em consentimento, transcrições, resumos e resultados.

Documentação

Servidor MCP ClawdCall

Dê aos agentes de IA acesso à API de execução telefônica voltada para agentes da ClawdCall por meio do Model Context Protocol.

clawdcall-mcp expõe o fluxo de trabalho confirmado da ClawdCall:

  • enviar OTP de cadastro
  • verificar OTP de cadastro
  • realizar chamadas de saída esperadas
  • buscar transcrições de chamadas

Remoto Hospedado

Conecte clientes MCP remotos compatíveis ao endpoint HTTP Streamable:

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

O endpoint anuncia metadados de recurso protegido por OAuth. Integrações existentes da ClawdCall também podem usar uma chave de API de acordo com a documentação do agente.

Pacote Stdio Local

Adicione o pacote npm publicado a um cliente MCP local:

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

CLAWDCALL_API_KEY é necessário para chamadas de saída e recuperação de transcrições. As ferramentas de OTP de cadastro não exigem uma chave existente.

Para roteamento de API de staging ou auto-hospedado:

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

Primeiro Teste Seguro

  1. Abra a configuração do agente ClawdCall.
  2. Conecte o endpoint hospedado ou o pacote local a partir de um cliente de agente compatível.
  3. Peça ao agente para ligar para você ou para um destinatário interno esperado com uma tarefa limitada.
  4. Confirme o destino e a tarefa antes de permitir a chamada.
  5. Revise o status retornado, a evidência da transcrição, o resumo ou o resultado estruturado.

A ClawdCall não se destina a chamadas frias, robocalls, divulgação em massa, uso emergencial, divulgação política ou fluxos de trabalho de aconselhamento sensível.

Exemplos de Copiar e Colar

O diretório examples contém fluxos de trabalho limitados de primeira chamada para:

Os exemplos de código mantêm o destinatário em variáveis de ambiente controladas pelo operador. A entrada gerada pelo agente não pode alterar o número de telefone, e efeitos colaterais ao vivo exigem aprovação explícita ou aceitação.

Ferramentas

FerramentaEndpoint confirmadoDescrição
send_signup_otpPOST /cc/signup/send-otpEnviar um OTP de verificação telefônica para cadastro.
verify_signup_otpPOST /cc/signup/verify-otpVerificar o OTP e receber detalhes da conta/chave de API.
place_outbound_callPOST /external/v1/agent/outbound?conversionFlag=1Realizar uma chamada de agente de voz de saída esperada.
get_call_transcriptGET /cc/v1/calls/{id}/transcriptBuscar uma transcrição por ID de chamada ou ID de campanha.

Variáveis de Ambiente

VariávelObrigatóriaPadrãoDescrição
CLAWDCALL_API_KEYPara ferramentas de chamada/transcriçãoChave de API da ClawdCall.
CLAWDCALL_BASE_URLNãohttps://api.clawdcall.comURL base da API.

Desenvolvimento

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

Compilar:

npm run build

Executar o servidor compilado:

CLAWDCALL_API_KEY=your_clawdcall_api_key npm start

Metadados de Descoberta

Contrato de API

Este servidor rastreia estes endpoints voltados para agentes da ClawdCall:

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

Não adicione ferramentas MCP para agentes, compra de números, SMS, conversas, vozes ou webhooks gerais até que essas rotas existam no contrato de API da ClawdCall.

Licença

MIT