Dialfetch

Dê ao seu agente de IA um telefone: faça chamadas reais, navegue por URAs, espere na linha e receba respostas estruturadas de volta.

Documentação

Dialfetch MCP — dê um telefone ao seu agente de IA ☎️

Conecte o Dialfetch ao Claude, Cursor, VS Code, Windsurf, Cline, ao Claude Agent SDK — ou a qualquer cliente Model Context Protocol — e seu agente poderá fazer chamadas telefônicas reais. Ele navega por árvores de IVR, espera na linha, conversa com pessoas (inclusive após uma transferência) e devolve respostas estruturadas, uma transcrição e uma gravação.

Dê a ele um número de telefone e um objetivo em linguagem simples. Objetivo entra, resultado sai.

"Ligue para a farmácia no +1 305-555-0148 e me diga a que horas ela fecha hoje." → { answers: { closing_time: { value: "9:00 PM", quote: "We close at nine tonight." } } }

  • 🔌 Endpoint: https://app.dialfetch.com/api/mcp (Streamable HTTP + SSE)
  • 🔑 Autenticação: chave de API (Authorization: Bearer df_…) ou OAuth com um clique para conectores personalizados
  • 📚 Documentação completa: https://app.dialfetch.com/docs/mcp
  • 🌐 Independente de setor: horários de varejo e farmácias, status de voos/viagens, status de pedidos e sinistros, verificação de licenças e seguros, linhas governamentais e de concessionárias

Conexão rápida

Claude Desktop

Adicione em claude_desktop_config.json (Configurações → Desenvolvedor → Editar configuração):

{
  "mcpServers": {
    "dialfetch": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.dialfetch.com/api/mcp",
               "--header", "Authorization: Bearer df_YOUR_KEY"]
    }
  }
}
Claude.ai (web) — conector personalizado

Configurações → Conectores → Adicionar conector personalizado → cole https://app.dialfetch.com/api/mcp e finalize o login OAuth com um clique. Não é necessário colar chave de API.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "dialfetch": {
      "url": "https://app.dialfetch.com/api/mcp",
      "headers": { "Authorization": "Bearer df_YOUR_KEY" }
    }
  }
}
VS Code (modo agente do Copilot)

.vscode/mcp.json:

{
  "servers": {
    "dialfetch": {
      "type": "http",
      "url": "https://app.dialfetch.com/api/mcp",
      "headers": { "Authorization": "Bearer df_YOUR_KEY" }
    }
  }
}

Mais configurações (Windsurf, Cline, Agent SDK) estão em configs/.

Ferramentas

FerramentaEntradasFunção
place_callphone, goal, extract?, context?, disclose_ai?, from_number_id?, max_duration_minutes?, webhook_url?Inicia uma chamada com objetivo; retorna { call_id, status } (assíncrono)
get_callcall_idStatus, resultado, respostas, anotações, transcrição, URL da gravação
wait_for_callcall_id, timeout_seconds?Bloqueia (com progresso) até a chamada ser finalizada
cancel_callcall_idCancela uma chamada na fila / em andamento
list_callsstatus?, limit?, cursor?Chamadas recentes, mais novas primeiro
get_call_recordingcall_idURL de áudio pré-assinada de curta duração
list_phone_numbersNúmeros de identificador de chamadas que você possui
get_pricingPreço por chamada / por número
get_credit_balanceSaldo de crédito pré-pago

Recurso: dialfetch://calls/{id} · Prompts: check_store_hours, verify_license, get_order_status

Como as chamadas funcionam

As chamadas são assíncronas (normalmente 2–10 minutos; mais longas com esperas ou transferências):

  1. place_call({ phone, goal, extract }){ call_id, status: "queued" }
  2. Consulte get_call({ call_id }) (ou use wait_for_call) até que status seja completed / failed / canceled
  3. Leia answers, transcript, recording_url

Receitas

Segurança

As chamadas informam por padrão que são de uma IA. O agente não lerá nem coletará dados pessoais sensíveis (SSNs, senhas, números completos de cartão). Triagem de objetivos, retenções de crédito e limites de taxa se aplicam a todas as chamadas e não podem ser contornados por um cliente.

Links

Licença

MIT — veja LICENSE.