PlaceCall

Realiza llamadas telefónicas reales a empresas de EE. UU. para reservas, consultas y cotizaciones; devuelve el resultado y la transcripción.

GitHub

Prueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

PlaceCall ☎️

Internet tiene APIs. El mundo real tiene números de teléfono.

Dale a tu agente una voz para llamar a cualquier negocio de EE. UU., gestionar reservas, recopilar información, obtener cotizaciones. Maneja IVRs y esperas. Devuelve resultado + transcripción. Primeras 250 llamadas gratis.

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"}'

Autenticación: cada solicitud lleva tu clave en el encabezado X-API-Key. Obtén una en https://api.voygr.tech/checkout: llega por correo electrónico.

Qué hace PlaceCall

Dale a PlaceCall un número de EE. UU. (o una lista) y una tarea en inglés sencillo, desde hacer una consulta hasta solicitar una cotización o completar una reserva, y marcará, navegará por IVRs y esperas, hablará con un negocio y devolverá un resultado verificado + transcripción + grabación.

¿Sin número? Solo describe el lugar: "un restaurante romántico en Chicago, sábado 8pm". PlaceCall encuentra candidatos, explica por qué los eligió y redacta el resumen de la llamada por ti.

Pon el trabajo completo en el resumen: qué preguntar, para quién es, nombres, fechas, tamaño del grupo, número de devolución de llamada y resultado deseado. El agente lee el resumen y luego hace las cosas. Si es necesario, los agentes harán preguntas durante la llamada.

Lo que tus agentes finalmente pueden hacer

🍽️ Reservar / cancelar / reprogramar mesas y citas
📦 Verificar información, dar seguimiento a pedidos, revisar stock, obtener cotizaciones
⚡️ Contactar a muchos negocios a la vez
📍 Recomendar el mejor lugar, servicio o proveedor cuando no tienes un número
✅ Informar exactamente lo que sucedió, plantear una pregunta durante la llamada si es necesario

Lo que obtienes a cambio

Cada llamada devuelve uno de 17 resultados verificados, más la transcripción completa y la grabación, incluidos motivos claros de fallo como llamadas caídas, líneas ocupadas, buzón de voz o números equivocados.

Por qué los desarrolladores usan PlaceCall

Construido para agentes que necesitan hacer las cosas. Construido por desarrolladores que mapearon el mundo: ex-equipo de Google Maps & Search.

🎁 Tus primeras 250 llamadas son por nuestra cuenta.

Si PlaceCall te resulta útil, déjanos una ⭐: ayuda mucho.

Instalación

Instalar la habilidad no requiere clave: solo le enseña a tu agente cómo llamar a la API. Agregas tu clave por separado (sección siguiente) antes de hacer llamadas reales.

Claude Code (recomendado)

Dos comandos, sin shell, sin git, y se actualiza automáticamente desde este repositorio:

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

Claude Code pregunta dónde instalarlo: elige ámbito de usuario ("Install for you") a menos que quieras específicamente confinarlo a un repositorio. La habilidad entonces responde a /placecall:placecall, y Claude la usa por su cuenta siempre que le pidas llamar a alguien.

Claude Code, sin el plugin

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

install.sh es un pequeño script de conveniencia: solo copia skills/placecall/SKILL.md a tu directorio de habilidades (sin red, sin otros efectos secundarios); también puedes copiarlo manualmente. Luego inicia una sesión nueva de Claude Code (las habilidades se cargan al inicio). Ten en cuenta que una copia nunca se actualiza sola: si quieres nuevas habilidades y correcciones a medida que las publicamos, prefiere el plugin anterior.

Cowork

Mismo paquete que el plugin de Claude Code, sin terminal:

Customize > Plugins > Add marketplace
Pega voygr-tech/placecall
Haz clic en Install en la tarjeta de PlaceCall

Se actualiza automáticamente desde este repositorio, como el plugin de Code.

Luego haz ambas cosas, en ~/.claude/settings.json. Cowork no tiene terminal, así que el export de la siguiente sección no tiene dónde ejecutarse, y el sandbox de Bash bloquea nuestra API hasta que lo permitas:

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

Reinicia Cowork después. Por qué importa cada parte:

env coloca la clave en un lugar que sobrevive un reinicio. Configurarla en un shell no llega a una aplicación de escritorio, que nunca ve ese shell.
allowedDomains preautoriza api.voygr.tech. Claude Code no preautoriza ningún dominio, así que sin esto obtienes un aviso de permiso en la primera llamada, y si tu organización configura strictAllowlist o allowManagedDomainsOnly, la llamada se bloquea por completo sin aviso. Ese es el "ajuste de administración profundo" que la gente encuentra.

Tu clave queda en texto plano en ese archivo, mismo nivel de confianza que el archivo de entorno 600 de la siguiente sección. chmod 600 ~/.claude/settings.json si quieres que los permisos de archivo coincidan.

Chat de claude.ai

Funciona en todos los planes mediante un conector personalizado con inicio de sesión. Sin clave que copiar.

Configuración. Planes personales: Settings > Connectors > Add custom connector. Team/Enterprise: un propietario lo agrega una vez en Organization settings > Connectors, y luego cada miembro inicia sesión con su propia cuenta de PlaceCall.

Nómbralo PlaceCall, URL https://api.voygr.tech/mcp. Mantén la configuración de inicio de sesión que Claude detecta.
Add, luego inicia sesión con Google o correo electrónico. En el primer inicio de sesión aceptas los Términos de Servicio y la Política de Privacidad, y se crea una cuenta de PlaceCall con créditos gratuitos.
Permite el acceso. PlaceCall aparece en el menú de herramientas de un chat, donde puede encontrar lugares que valga la pena llamar, hacer una llamada (siempre confirma primero) y obtener el resultado.

¿Prefieres una clave de API para todo un espacio de trabajo? Agrega el conector con No sign-in y un encabezado de solicitud x-api-key que lleve tu clave. Todas las llamadas se facturan a esa clave.

ChatGPT

Agrega PlaceCall como una aplicación personalizada en ChatGPT en la web. Las aplicaciones personalizadas dependen de tu plan de ChatGPT.

Abre Plugins, luego + > Create plugin > Create MCP App.
Nómbralo PlaceCall, URL del servidor https://api.voygr.tech/mcp, autenticación OAuth. Deja los ajustes de OAuth que ChatGPT descubre como están, acepta el aviso de aplicación personalizada y Create.
Inicia sesión con Google o correo electrónico. En el primer inicio de sesión aceptas los Términos de Servicio y la Política de Privacidad, y se crea una cuenta de PlaceCall con créditos gratuitos.
En un chat, elige PlaceCall desde el menú de herramientas.

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

Apunta el cliente a https://api.voygr.tech/mcp (transporte HTTP transmisible). Está listado en el Registro MCP oficial como io.github.voygr-tech/placecall. Inicia sesión con OAuth donde tu cliente lo soporte, o envía tu clave en cada solicitud: cualquiera de los dos encabezados funciona:

X-API-Key: <your key>

o Authorization: Bearer <your key>.

Claude Code mantiene su propia configuración de MCP (no recoge los conectores de claude.ai), así que agrégalo allí con un comando:

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

--scope user lo hace disponible en cada proyecto. El plugin al inicio de esta página sigue siendo la ruta más rica para Claude Code: lleva la habilidad completa, no solo las tres herramientas.

Codex

Escribe esto dentro de Codex, no en tu shell. $skill-installer es una habilidad del sistema incluida con Codex, así que no hay nada que configurar primero:

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

Es una habilidad más que un comando, así que el inglés sencillo funciona y es lo que espera. Ejecuta la instalación por ti e informa dónde quedó la habilidad. No se necesita reinicio, está disponible en tu siguiente turno, y responde a $placecall.

Si la frase anterior no se entiende, este es el script que ejecuta, y puedes ejecutarlo tú mismo desde un 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

Dos cosas que vale la pena saber. El instalador se niega a sobrescribir, así que si ya tienes una habilidad placecall (o la más antigua callwright) en ~/.codex/skills, elimínala primero o la instalación se aborta. Y no ejecutes install.sh en Codex, ese es el camino de Claude Code.

La carpeta de habilidades se movió de skills/call a skills/placecall en octubre de 2026, así que una línea de instalación que aún diga .../tree/main/skills/call ya no la encuentra. Una copia que ya instalaste sigue funcionando y aún responde a $placecall. Para obtener versiones más nuevas, elimínala y reinstala desde la URL skills/placecall anterior.

En Codex más antiguo sin $skill-installer, o como alternativa en cualquier Codex, pega el AGENTS.md de este repositorio en tu AGENTS.md del proyecto.

Hermes Agent

Un comando, y solicita la clave en lugar de tomarla en la línea de comandos, así que nada termina en tu historial de shell:

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

Responde Y a "Does this server require authentication?", pega la clave en el aviso enmascarado, y Y para habilitar las cuatro herramientas. Hermes almacena la clave en ~/.hermes/.env (como MCP_PLACECALL_API_KEY) y escribe solo una referencia ${...} en config.yaml, así que el valor nunca está en el archivo de configuración. Verifica con hermes mcp test placecall, luego inicia una nueva sesión: las herramientas se cargan al inicio de la sesión.

No uses la ruta de habilidad en Hermes. hermes skills install placecall es rechazado por el propio escáner de Hermes: una habilidad que envía una clave de API con curl a cualquier host que no sea de bucle local es un hallazgo crítico por diseño de ese escáner, que es lo que nuestra habilidad hace en cada llamada. MCP no tiene shell ni variable de entorno en la solicitud, así que la regla no aplica. La barra diagonal final en la URL importa.

Gemini CLI

Este repositorio también es una extensión de Gemini CLI: la habilidad más el servidor MCP de PlaceCall. Instálalo desde tu shell:

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

La instalación solicita tu clave de API de PlaceCall y la guarda en el llavero del sistema (cámbiala más tarde con gemini extensions config placecall). Gemini entrega esa clave almacenada solo al servidor MCP. Los comandos curl de la habilidad se ejecutan en tu shell y leen PLACECALL_API_KEY desde allí, así que expórtala también (ver Get a key). Si la clave está exportada pero no almacenada, el servidor MCP también la recoge de tu entorno.

Cursor

Este repositorio también es un plugin de Cursor (.cursor-plugin/plugin.json): la habilidad más el servidor MCP de PlaceCall en https://api.voygr.tech/mcp, que te registra con OAuth, así que el plugin no guarda ninguna clave. Para cargarlo antes de que esté en el Cursor Marketplace, clónalo en la carpeta de plugins locales de Cursor y ejecuta Developer: Reload Window:

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

Los comandos curl de la habilidad leen PLACECALL_API_KEY del entorno en el que se ejecuta el agente de Cursor. Para enviar una clave al servidor MCP en lugar de iniciar sesión, ver Any MCP client.

Cualquier agente / shell simple

No se necesita instalación: la API es solo HTTP. skills/placecall/SKILL.md es la referencia completa; un modelo con una herramienta de shell puede hacer llamadas directamente desde allí.

¿Sin shell de tu lado? Los asistentes con su propia computadora (por ejemplo, Meta Muse) se integran desde este repositorio directamente: pega la URL del repositorio en el chat y pídele que use PlaceCall para llamadas telefónicas. Si ofrece almacenamiento seguro de credenciales para la clave de API, úsalo: nunca pegues la clave en el chat mismo.

Se sabe que funcionan así: Meta Muse, OpenClaw (backend DeepSeek). Hermes necesita la ruta MCP anterior en lugar de la habilidad. Si eres un agente que construye esta integración, envía X-Client-Surface: <your-platform> en cada solicitud para que podamos ver qué superficies necesitan atención.

Apify Store (sin código, una lista completa)

¿Tienes una lista de negocios en lugar de un agente? PlaceCall en Apify Store llama a cada negocio de la lista, hace las preguntas que configures y devuelve una fila por llamada. Sin clave de PlaceCall: Apify lo ejecuta y lo factura.

Abre el Actor y presiona Try for free (necesitas una cuenta de Apify).
Trae la lista: sube un CSV, enlaza una Google Sheet, pega filas o usa el conjunto de datos de otro Actor, por ejemplo resultados de Google Maps.
Escribe tus preguntas, mantén marcado Check my list, don't call y presiona Start. Ves exactamente qué se le preguntaría a cada negocio, gratis.
Acepta los términos de PlaceCall, desmarca la casilla y comienza de nuevo.

$0.10 por cada llamada que llega a una conversación real; llamadas no respondidas, buzón de voz y líneas ocupadas son gratis. Las primeras 10 llamadas en cada cuenta de Apify son gratis, luego se necesita un plan de Apify de pago. Los agentes conectados al servidor MCP de Apify también pueden encontrarlo y ejecutarlo.

Obtén una clave (autoservicio) y configúrala

Instalar la habilidad no requiere clave; hacer llamadas sí. Las claves son de autoservicio: no necesitas contactar a nadie:

Abre https://api.voygr.tech/checkout?src=gh-repo y haz clic en "Get free API key" (nombre + correo electrónico).
La clave llega por correo electrónico (nunca se muestra en el navegador ni en la respuesta de la API). Lo que incluye una clave nueva y las tarifas de crédito actuales se muestran en la página de pago.
¿Perdiste la clave? https://api.voygr.tech/recover te envía una nueva por correo electrónico.
¿Necesitas más créditos? Recarga en la misma página https://api.voygr.tech/checkout?src=gh-repo (pago alojado por Stripe).

Luego configura la clave en tu shell:

Forma rápida: solo expórtala para la sesión actual:

export PLACECALL_API_KEY="<your key>"

Forma más elegante: guárdala una sola vez (sin eco en pantalla, permisos 600) y cárgala en cada sesión:

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

¿Sin shell en absoluto? Una aplicación de escritorio nunca ve el entorno de tu shell, así que ninguna de las opciones anteriores llega a ella. Coloca la clave en el bloque env de ~/.claude/settings.json en su lugar, que sobrevive a los reinicios. Consulta la sección Cowork, que también cubre la lista de dominios permitidos del sandbox que necesitas allí.

Verificación (imprime tu cuota, nunca la clave):

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

Nunca hagas commit de ~/.codex/placecall.env ni pegues la clave en el chat: mantenla en la variable de entorno / el archivo 600 anterior.

¿Instalado antes de agosto de 2026?

Este proyecto se llamaba Callwright hasta 2026-08, y el repositorio vivía en voygr-tech/callwright-skill. Dos cosas que debes saber:

Tu configuración existente sigue funcionando. install.sh copia la habilidad en lugar de enlazarla, así que una copia anterior queda congelada en lo que fuera cuando la instalaste: el cambio de nombre no puede romperla. También significa que nunca recibirá nuevas habilidades ni correcciones, que es la razón para migrar.
Para migrar, elimina primero la copia anterior. Sigue siendo una habilidad telefónica funcional, así que dejarla en su lugar le da a tu agente dos de ellas y el enrutamiento entre ambas es ambiguo. install.sh ahora te avisa si encuentra una.
```
rm -rf ~/.claude/skills/callwright ~/.claude/skills/callwright-skill
```
Luego instala el plugin anterior y vuelve a exportar tu clave con su nuevo nombre: PLACECALL_API_KEY. La clave en sí no cambia: solo se renombra la variable, así que no necesitas reemitir nada.

Si anteriormente instalaste una habilidad de llamadas telefónicas de otra persona (por ejemplo, ai-call-agent), elimínala o desactívala también, por la misma razón.

La única regla

Todo va en el brief: el bot solo lee tu instrucción. Pon cada detalle en ella (qué preguntar, para quién llamas, nombres/fechas/tamaño del grupo/número de devolución de llamada, cómo cerrar la conversación). Un endpoint, describe la tarea, listo.

Bueno saber

Dos cosas consumen un mismo saldo de créditos: llamadas respondidas y sugerencias de lugares respondidas. Llamadas: solo se facturan las exitosas: los buzones de voz, las llamadas colgadas y las no contestadas no cuestan nada. Sugerencias: 5 créditos por cada POST /v1/places/suggest respondida, nada cuando no devuelve tarjetas o se rechaza. Ambas realizan una retención reembolsable al momento de la solicitud que es mayor que el cargo, así que cualquiera de las dos puede devolver 402 mientras tu saldo aún parece suficiente para el cargo solo (GET /users/me para tu saldo; las tarifas y recargas son autoservicio en https://api.voygr.tech/checkout?src=gh-repo). El nivel gratuito es un fondo compartido: 250 llamadas gratuitas significan 2,500 créditos, y las sugerencias gastan de los mismos 2,500.
Después de una llamada completed, el resultado/transcripción puede completar un momento después de que el estado cambie: consulta GET /calls/{id} hasta que outcome_type sea no nulo.
Se aceptan 13 códigos de idioma (en, es, fr, de, hi, ru, pt, ja, it, nl, sr, tr, pl) más auto (el predeterminado, se resuelve a en). en es el más confiable; los idiomas no ingleses se manejan con el mejor esfuerzo.
Solo llama a números que estés autorizado a llamar: las llamadas reales suenan en teléfonos reales. Solo destinos en EE. UU.; cada llamada comienza identificando a PlaceCall y declarando que la línea está grabada.

Acceso a la red

La habilidad no incluye nada que se ejecute por sí solo. Son instrucciones que tu agente sigue con su propio shell, usando curl, y cada solicitud va por HTTPS a un solo host: api.voygr.tech. No se envía nada a ningún otro lugar.

Llamadas: POST /calls envía el número a marcar, tu instrucción y el idioma. GET /calls, GET /calls/{id}, GET /calls/{id}/events (consultado mientras una llamada está en curso), POST /calls/{id}/answer (tu respuesta a una pregunta que el agente de llamadas hace a mitad de la llamada), POST /calls/{id}/cancel, GET /calls/{id}/transcript-merged y GET /calls/{id}/recording siguen y lo leen.
Encontrar un lugar para llamar: POST /v1/places/suggest envía tu solicitud en palabras simples, más el nombre y el número de devolución de llamada cuando los proporcionas.
Cuenta: GET /users/me, GET /v1/usage, GET /checkout/packs, GET /skills/{id}/manifest y PUT /users/me/limits.

Cada solicitud lleva tu clave en el encabezado X-API-Key, así que PLACECALL_API_KEY va a api.voygr.tech y a ningún otro lugar. POST /calls también envía tres encabezados que nunca afectan la autenticación ni la facturación: un Idempotency-Key para que un reintento no pueda marcar dos veces, X-Client-Surface que nombra el listado del que provienen estas instrucciones, y X-Client-Agent que nombra la herramienta que realizó la llamada (claude-code, cursor, codex o gemini-cli, determinado a partir de cuál de CLAUDECODE, CURSOR_AGENT, CODEX_SANDBOX y GEMINI_CLI está configurado; solo se envía el nombre, nunca el valor de una variable).

El único archivo local que la habilidad lee es ~/.codex/placecall.env, tu clave guardada, y solo cuando PLACECALL_API_KEY no está configurada. install.sh no realiza llamadas de red. El plugin de Cursor y la extensión de CLI de Gemini también se conectan al servidor MCP de PlaceCall en https://api.voygr.tech/mcp, el mismo host. Los enlaces de pago, recuperación y documentación en este README son páginas para que las abras; la habilidad no las obtiene.

De nuestro lado, una llamada suena en un teléfono real y se graba. Las grabaciones y transcripciones se conservan durante 90 días. Informes de seguridad: SECURITY.md.

Referencia completa: skills/placecall/SKILL.md (Claude Code) · AGENTS.md (Codex).

Documentación de API en vivo: https://api.voygr.tech/docs: inicia sesión con tu clave de PlaceCall (la misma que configuraste como PLACECALL_API_KEY).