PlaceCall

Faz ligações telefônicas reais para empresas dos EUA para reservas, consultas e cotações; retorna o resultado e a transcrição.

GitHub

Experimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://api.voygr.tech/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

PlaceCall ☎️

A internet tem APIs. O mundo real tem números de telefone.

Dê ao seu agente uma voz para ligar para qualquer empresa nos EUA, fazer reservas, coletar informações, obter cotações. Lida com URAs e espera. Retorna resultado + transcrição. Primeiras 250 ligações grátis.

curl -s -X POST https://api.voygr.tech/calls \
  -H "X-API-Key: $PLACECALL_API_KEY" -H "Content-Type: application/json" \
  -H "X-Client-Surface: gh-repo" \
  -H "X-Client-Agent: ${CLAUDECODE:+claude-code}${CURSOR_AGENT:+cursor}${CODEX_SANDBOX:+codex}${GEMINI_CLI:+gemini-cli}" \
  -d '{"target_phone":"+1XXXXXXXXXX","brief":"Call this restaurant and ask what time the kitchen closes tonight.","language":"en"}'

Autenticação: toda requisição carrega sua chave no cabeçalho X-API-Key. Obtenha uma em https://api.voygr.tech/checkout - ela chega por e-mail.

O que o PlaceCall faz

Dê ao PlaceCall um número dos EUA (ou uma lista) e uma tarefa em inglês simples - desde fazer uma consulta até solicitar uma cotação ou concluir uma reserva - e ele disca, navega por URAs e espera, conversa com uma empresa e retorna um resultado verificado + transcrição + gravação.

Sem número? Basta descrever o lugar: "um restaurante romântico em Chicago, sábado às 20h". O PlaceCall encontra candidatos, explica por que os escolheu e escreve o briefing da ligação para você.

Coloque todo o trabalho no briefing - o que perguntar, para quem é, nomes, datas, tamanho do grupo, número para retorno e resultado desejado. O agente lê o briefing e resolve as coisas. Se necessário - os agentes farão perguntas durante a ligação.

O que seus agentes finalmente podem fazer

🍽️ Reservar / cancelar / remarcar mesas e compromissos
📦 Verificar informações, acompanhar pedidos, checar estoque, obter cotações
⚡️ Contatar várias empresas de uma vez
📍 Recomendar o melhor local, serviço ou fornecedor quando você não tem um número
✅ Relatar exatamente o que aconteceu, levantar uma pergunta durante a ligação se necessário

O que você recebe de volta

Cada ligação retorna um dos 17 resultados verificados, além da transcrição completa e da gravação - incluindo motivos claros de falha, como chamadas perdidas, linhas ocupadas, caixa postal ou números errados.

Por que desenvolvedores usam o PlaceCall

Feito para agentes que precisam resolver as coisas. Criado por desenvolvedores que mapearam o mundo - ex-equipe do Google Maps & Search.

🎁 Suas primeiras 250 ligações são por nossa conta.

Se o PlaceCall for útil, deixe uma ⭐ - ajuda muito.

Instalação

Instalar a skill não precisa de chave - ela apenas ensina seu agente a chamar a API. Você adiciona sua chave separadamente (próxima seção) antes de fazer ligações reais.

Claude Code (recomendado)

Dois comandos, sem shell, sem git - e ele atualiza automaticamente a partir deste repositório:

/plugin marketplace add voygr-tech/placecall
/plugin install placecall@placecall

O Claude Code pergunta onde instalar - escolha escopo do usuário ("Instalar para você") a menos que você queira especificamente confiná-lo a um repositório. A skill então responde a /placecall:placecall, e o Claude a utiliza por conta própria sempre que você pedir para ligar para alguém.

Claude Code, sem o plugin

git clone https://github.com/voygr-tech/placecall && cd placecall
./install.sh     # copies skills/placecall/SKILL.md -> ~/.claude/skills/placecall/

install.sh é um pequeno script de conveniência - ele apenas copia skills/placecall/SKILL.md para o diretório de skills (sem rede, sem outros efeitos colaterais); você também pode copiá-lo manualmente. Depois inicie uma nova sessão do Claude Code (as skills carregam na inicialização). Observe que uma cópia nunca se atualiza - se você quiser novas skills e correções conforme as lançamos, prefira o plugin acima.

Cowork

Mesmo pacote do plugin do Claude Code, sem terminal algum:

Personalizar > Plugins > Adicionar marketplace
Cole voygr-tech/placecall
Clique em Instalar no cartão do PlaceCall

Atualiza automaticamente a partir deste repositório, como o plugin do Code.

Depois faça ambas as coisas, em ~/.claude/settings.json. O Cowork não tem terminal, então o export na próxima seção não tem onde rodar, e o sandbox Bash bloqueia nossa API até você permitir:

{
  "env": { "PLACECALL_API_KEY": "<your key>" },
  "sandbox": { "network": { "allowedDomains": ["api.voygr.tech"] } }
}

Reinicie o Cowork depois. Por que cada parte importa:

env coloca a chave em um local que sobrevive a uma reinicialização. Definir em um shell não alcança um aplicativo de desktop, que nunca vê esse shell.
allowedDomains pré-autoriza api.voygr.tech. O Claude Code não pré-autoriza nenhum domínio, então sem isso você recebe um prompt de permissão na primeira ligação, e se sua organização define strictAllowlist ou allowManagedDomainsOnly a ligação é bloqueada diretamente sem prompt. Essa é a "configuração de administrador profunda" que as pessoas encontram.

Sua chave fica em texto puro nesse arquivo, no mesmo nível de confiança do arquivo de ambiente 600 na próxima seção. chmod 600 ~/.claude/settings.json se você quiser que as permissões de arquivo correspondam.

chat do claude.ai

Funciona em todos os planos via um conector personalizado com login. Sem chave para copiar.

Configuração. Planos pessoais: Configurações > Conectores > Adicionar conector personalizado. Team/Enterprise: um Owner adiciona uma vez em Configurações da organização > Conectores, e cada membro então faz login com sua própria conta PlaceCall.

Nomeie como PlaceCall, URL https://api.voygr.tech/mcp. Mantenha a configuração de login que o Claude detecta.
Adicionar, depois faça login com Google ou e-mail. No primeiro login você aceita os Termos de Serviço e a Política de Privacidade, e uma conta PlaceCall é criada com créditos gratuitos.
Permita o acesso. O PlaceCall aparece no menu de ferramentas de um chat, onde pode encontrar lugares que valem a pena ligar, fazer uma ligação (sempre confirma primeiro) e buscar o resultado.

Prefere uma chave de API para todo o workspace? Adicione o conector com Sem login e um cabeçalho de requisição x-api-key carregando sua chave. Todas as chamadas então são cobradas nessa chave.

ChatGPT

Adicione o PlaceCall como um aplicativo personalizado no ChatGPT na web. Aplicativos personalizados dependem do seu plano do ChatGPT.

Abra Plugins, depois + > Criar plugin > Criar app MCP.
Nomeie como PlaceCall, URL do servidor https://api.voygr.tech/mcp, autenticação OAuth. Deixe as configurações de OAuth que o ChatGPT descobre como estão, aceite o aviso de aplicativo personalizado e Criar.
Faça login com Google ou e-mail. No primeiro login você aceita os Termos de Serviço e a Política de Privacidade, e uma conta PlaceCall é criada com créditos gratuitos.
Em um chat, escolha PlaceCall no menu de ferramentas.

Qualquer cliente MCP (Cursor, Windsurf, MCP Inspector, ...)

Aponte o cliente para https://api.voygr.tech/mcp (transporte HTTP streamable). Ele está listado no Registro MCP oficial como io.github.voygr-tech/placecall. Faça login com OAuth onde seu cliente suportar, ou envie sua chave em toda requisição - qualquer cabeçalho funciona:

X-API-Key: <your key>

ou Authorization: Bearer <your key>.

O Claude Code mantém sua própria configuração MCP (ele não capta conectores do claude.ai), então adicione lá com um comando:

claude mcp add --transport http --scope user placecall https://api.voygr.tech/mcp \
  --header "X-API-Key: <your key>"

--scope user o torna disponível em todos os projetos. O plugin no topo desta página ainda é o caminho mais rico para o Claude Code - ele carrega a skill completa, não apenas as três ferramentas.

Codex

Digite isso dentro do Codex, não no seu shell. $skill-installer é uma skill de sistema incluída no Codex, então não há nada para configurar primeiro:

$skill-installer install the skill at https://github.com/voygr-tech/placecall/tree/main/skills/placecall and name it placecall

É uma skill em vez de um comando, então inglês simples funciona e é o que ela espera. Ela executa a instalação para você e relata onde a skill foi instalada. Sem necessidade de reiniciar, ela está disponível no seu próximo turno, e responde a $placecall.

Se a frase acima não for entendida, este é o script que ela executa, e você pode executá-lo você mesmo de um shell normal:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --url https://github.com/voygr-tech/placecall/tree/main/skills/placecall \
  --name placecall

Duas coisas que vale saber. O instalador se recusa a sobrescrever, então se você já tem uma skill placecall (ou a mais antiga callwright) em ~/.codex/skills, exclua-a primeiro ou a instalação aborta. E não execute install.sh no Codex, esse é o caminho do Claude Code.

A pasta da skill mudou de skills/call para skills/placecall em outubro de 2026, então uma linha de instalação que ainda diz .../tree/main/skills/call não a encontra mais. Uma cópia que você já instalou continua funcionando e ainda responde a $placecall. Para obter versões mais novas, exclua-a e reinstale a partir da URL skills/placecall acima.

Em Codex mais antigo sem $skill-installer, ou como alternativa em qualquer Codex, cole o AGENTS.md deste repositório no AGENTS.md do seu projeto.

Hermes Agent

Um comando, e ele solicita a chave em vez de recebê-la na linha de comando, então nada cai no histórico do seu shell:

hermes mcp add placecall --url https://api.voygr.tech/mcp/ --auth header

Responda Y a "Este servidor requer autenticação?", cole a chave no prompt mascarado, e Y para habilitar todas as quatro ferramentas. O Hermes armazena a chave em ~/.hermes/.env (como MCP_PLACECALL_API_KEY) e escreve apenas uma referência ${...} no config.yaml, então o valor nunca está no arquivo de configuração. Verifique com hermes mcp test placecall, depois inicie uma nova sessão - as ferramentas carregam no início da sessão.

Não use o caminho de skill no Hermes. hermes skills install placecall é recusado pelo próprio scanner do Hermes: uma skill que envia uma chave de API com curl para qualquer host não-loopback é uma descoberta crítica pelo design desse scanner, que é o que nossa skill faz em toda chamada. MCP não tem shell e nenhuma variável de ambiente na requisição, então a regra não se aplica. A barra final na URL importa.

Gemini CLI

Este repositório também é uma extensão do Gemini CLI: a skill mais o servidor MCP PlaceCall. Instale a partir do seu shell:

gemini extensions install https://github.com/voygr-tech/placecall

A instalação pede sua chave de API do PlaceCall e a mantém no chaveiro do sistema (altere depois com gemini extensions config placecall). O Gemini entrega essa chave armazenada apenas ao servidor MCP. Os comandos curl da skill rodam no seu shell e leem PLACECALL_API_KEY de lá, então exporte-a também (veja Obter uma chave). Se a chave estiver exportada mas não armazenada, o servidor MCP também a capta do seu ambiente.

Cursor

Este repositório também é um plugin do Cursor (.cursor-plugin/plugin.json): a skill mais o servidor MCP PlaceCall em https://api.voygr.tech/mcp, que faz login com OAuth, então o plugin não guarda chave. Para carregá-lo antes de estar no Cursor Marketplace, clone-o na pasta de plugins locais do Cursor e execute Developer: Reload Window:

git clone https://github.com/voygr-tech/placecall ~/.cursor/plugins/local/placecall

Os comandos curl da skill leem PLACECALL_API_KEY do ambiente em que o agente do Cursor roda. Para enviar uma chave ao servidor MCP em vez de fazer login, veja Qualquer cliente MCP.

Qualquer agente / shell simples

Sem instalação necessária - a API é apenas HTTP. skills/placecall/SKILL.md é a referência completa; um modelo com ferramenta de shell pode fazer ligações diretamente dela.

Sem shell do seu lado? Assistentes com computador próprio (ex.: Meta Muse) integram a partir deste repositório diretamente: cole a URL do repositório no chat e peça para usar o PlaceCall para ligações telefônicas. Se ele oferecer armazenamento seguro de credenciais para a chave de API, use isso - nunca cole a chave no próprio chat.

Sabidamente funciona assim: Meta Muse, OpenClaw (backend DeepSeek). Hermes precisa do caminho MCP acima em vez da skill. Se você é um agente construindo essa integração, envie X-Client-Surface: <your-platform> em toda requisição para que possamos ver quais superfícies precisam de atenção.

Apify Store (sem código, uma lista inteira)

Tem uma lista de empresas em vez de um agente? PlaceCall na Apify Store liga para cada empresa da lista, faz as perguntas que você definiu e retorna uma linha por ligação. Sem chave PlaceCall: o Apify executa e cobra.

Abra o Actor e pressione Experimente grátis (você precisa de uma conta Apify).
Traga a lista: envie um CSV, vincule uma Google Sheet, cole linhas ou use o conjunto de dados de outro Actor, por exemplo resultados do Google Maps.
Digite suas perguntas, mantenha Verificar minha lista, não ligar marcado e pressione Iniciar. Você vê exatamente o que seria perguntado a cada empresa, de graça.
Aceite os termos do PlaceCall, desmarque a opção e inicie novamente.

$0,10 para cada ligação que alcança uma conversa real; ligações não atendidas, caixa postal e linhas ocupadas são gratuitas. As primeiras 10 ligações em cada conta Apify são gratuitas, depois é necessário um plano Apify pago. Agentes conectados ao servidor MCP do Apify também podem encontrá-lo e executá-lo.

Obter uma chave (autoatendimento) e defini-la

Instalar a skill não precisa de chave; fazer ligações precisa. Chaves são autoatendimento - sem necessidade de contatar ninguém:

Abra https://api.voygr.tech/checkout?src=gh-repo e clique em "Obter chave de API gratuita" (nome + e-mail).
A chave chega por e-mail (ela nunca é mostrada no navegador ou na resposta da API). O que uma nova chave inclui, e as taxas de crédito atuais, são mostrados na página de checkout.
Perdeu a chave? https://api.voygr.tech/recover envia uma nova por e-mail.
Precisa de mais créditos? Recarregue na mesma página https://api.voygr.tech/checkout?src=gh-repo (pagamento hospedado pelo Stripe).

Depois defina a chave no seu shell:

Caminho rápido - basta exportá-la para a sessão atual:

export PLACECALL_API_KEY="<your key>"

Forma mais elegante — salve uma vez (sem eco na tela, permissões 600) e carregue por sessão:

mkdir -p ~/.codex
read -rsp "PLACECALL_API_KEY: " KEY; echo
printf 'export PLACECALL_API_KEY=%q\n' "$KEY" > ~/.codex/placecall.env
chmod 600 ~/.codex/placecall.env
unset KEY
# then, in any new shell where you want to place calls:
source ~/.codex/placecall.env

Sem shell? Um aplicativo de desktop nunca vê o ambiente do seu shell, então nenhuma das opções acima o alcança. Coloque a chave no bloco env do ~/.claude/settings.json em vez disso, que sobrevive a reinicializações. Veja a seção Cowork, que também cobre a lista de permissões de domínio do sandbox que você precisa lá.

Verifique (imprime sua cota, nunca a chave):

curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/users/me

Nunca faça commit de ~/.codex/placecall.env nem cole a chave no chat — mantenha-a na variável de ambiente / no arquivo 600 acima.

Instalou antes de agosto de 2026?

Este projeto se chamava Callwright até 2026-08, e o repositório ficava em voygr-tech/callwright-skill. Duas coisas para saber:

Sua configuração existente continua funcionando. install.sh copia a skill em vez de vinculá-la, então uma cópia antiga fica congelada no estado em que estava quando você instalou — a renomeação não pode quebrá-la. Isso também significa que ela nunca receberá novas skills ou correções, o que é o motivo para migrar.
Para migrar, exclua a cópia antiga primeiro. Ela ainda é uma skill de telefone funcional, então deixá-la no lugar dá ao seu agente duas delas e o roteamento entre elas fica ambíguo. install.sh agora avisa se encontrar uma.
```
rm -rf ~/.claude/skills/callwright ~/.claude/skills/callwright-skill
```
Em seguida, instale o plugin acima e reexporte sua chave com o novo nome: PLACECALL_API_KEY. A chave em si não muda — apenas a variável é renomeada, então não é necessário reemitir nada.

Se você instalou anteriormente uma skill de chamadas telefônicas de outra pessoa (por exemplo, ai-call-agent), remova ou desative-a também, pelo mesmo motivo.

A única regra

Tudo vai no brief — o bot lê apenas o seu briefing. Coloque cada detalhe nele (o que perguntar, para quem você está ligando, nomes/datas/tamanho do grupo/número para retorno, como encerrar). Um endpoint, descreva a tarefa, pronto.

Bom saber

Duas coisas consomem o mesmo saldo de créditos: chamadas atendidas e sugestões de lugares atendidas. Chamadas: apenas as bem-sucedidas são cobradas — caixas postais, desligamentos e não atendimentos não custam nada. Sugestões: 5 créditos por POST /v1/places/suggest atendido, nada quando não retorna cartões ou é recusada. Ambas fazem uma retenção reembolsável no momento da solicitação, maior que a cobrança, então qualquer uma pode retornar 402 enquanto seu saldo ainda parece suficiente para a cobrança sozinha (GET /users/me para seu saldo; taxas e recargas são autoatendidas em https://api.voygr.tech/checkout?src=gh-repo). O nível gratuito é um único pote compartilhado: 250 chamadas gratuitas significam 2.500 créditos, e as sugestões gastam dos mesmos 2.500.
Após uma chamada completed, o resultado/transcrição pode preencher um momento depois que o status muda — faça polling de GET /calls/{id} até que outcome_type seja não nulo.
13 códigos de idioma aceitos (en, es, fr, de, hi, ru, pt, ja, it, nl, sr, tr, pl) mais auto (o padrão, resolve para en). en é o mais confiável; idiomas não ingleses são melhor esforço.
Ligue apenas para números que você está autorizado a usar — chamadas reais tocam telefones reais. Apenas destinos nos EUA; toda chamada começa identificando o PlaceCall e declarando que a linha está gravada.

Acesso à rede

A skill não inclui nada que execute por conta própria. São instruções que seu agente segue com o próprio shell, usando curl, e toda solicitação vai por HTTPS para um único host: api.voygr.tech. Nada é enviado para qualquer outro lugar.

Chamadas: POST /calls envia o número para discar, seu briefing e o idioma. GET /calls, GET /calls/{id}, GET /calls/{id}/events (consultado enquanto uma chamada está em andamento), POST /calls/{id}/answer (sua resposta a uma pergunta que o agente da chamada faz no meio dela), POST /calls/{id}/cancel, GET /calls/{id}/transcript-merged e GET /calls/{id}/recording seguem e leem isso.
Encontrar um lugar para ligar: POST /v1/places/suggest envia sua solicitação em palavras simples, além do nome e número para retorno quando você os fornece.
Conta: GET /users/me, GET /v1/usage, GET /checkout/packs, GET /skills/{id}/manifest e PUT /users/me/limits.

Toda solicitação carrega sua chave no cabeçalho X-API-Key, então PLACECALL_API_KEY vai para api.voygr.tech e nenhum outro lugar. POST /calls também envia três cabeçalhos que nunca afetam autenticação ou cobrança: um Idempotency-Key para que uma nova tentativa não disque duas vezes, X-Client-Surface nomeando a listagem de onde estas instruções vieram, e X-Client-Agent nomeando a ferramenta que fez a chamada (claude-code, cursor, codex ou gemini-cli, determinado a partir de qual de CLAUDECODE, CURSOR_AGENT, CODEX_SANDBOX e GEMINI_CLI está definido; apenas o nome é enviado, nunca o valor de uma variável).

O único arquivo local que a skill lê é ~/.codex/placecall.env, sua chave salva, e apenas quando PLACECALL_API_KEY não está definido. install.sh não faz chamadas de rede. O plugin do Cursor e a extensão da CLI do Gemini também se conectam ao servidor MCP do PlaceCall em https://api.voygr.tech/mcp, o mesmo host. Os links de checkout, recuperação e documentação neste README são páginas para você abrir; a skill não as busca.

Do nosso lado, uma chamada toca um telefone real e é gravada. Gravações e transcrições são mantidas por 90 dias. Relatórios de segurança: SECURITY.md.

Referência completa: skills/placecall/SKILL.md (Claude Code) · AGENTS.md (Codex).

Documentação da API ao vivo: https://api.voygr.tech/docs — faça login com sua chave do PlaceCall (a mesma que você definiu como PLACECALL_API_KEY).