Deyaho Phone Calls MCP

Deyaho Phone Calls MCP

Let Claude, ChatGPT, Cursor or any AI agent make real phone calls to Mexico and Spain. A remote MCP server: your agent calls a tool with a phone number and a goal, a Deyaho AI voice agent places the call, and you get back the summary, the collected data and the full transcript.

• Endpoint: https://mcp.deyaho.com/mcp (Streamable HTTP, OAuth or API key)
• Price: 0.25 USD per connected minute, telephony included, no monthly fee. Unanswered, busy and voicemail calls are free.
• Destinations: Mexico (+52) and Spain (+34), called from local numbers (Mexico City and Madrid)
• Hours: service calls Monday to Saturday 09:00-21:00; commercial calls Monday to Friday (commercial calls to Spain go out from a 400 number)
• Languages: Spanish or English
• Website, guide and FAQ: https://deyaho.com/en/mcp (Spanish: https://deyaho.com/mcp)

Español más abajo

Install

Get a free Deyaho account and top up minutes at https://app.deyaho.com/dashboard/mcp. That page also creates API keys (dy_mcp_...) for clients that use one.

Claude (claude.ai and Claude Desktop): Settings > Connectors > Add custom connector, paste https://mcp.deyaho.com/mcp, click Connect and sign in with your Deyaho account (OAuth, no key needed).

Claude Code:

claude mcp add --transport http deyaho-calls https://mcp.deyaho.com/mcp --header "Authorization: Bearer dy_mcp_YOUR_KEY"

Without the header, sign in from /mcp inside Claude Code.

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

{
  "mcpServers": {
    "deyaho-calls": {
      "url": "https://mcp.deyaho.com/mcp",
      "headers": { "Authorization": "Bearer dy_mcp_YOUR_KEY" }
    }
  }
}

ChatGPT: Settings > Apps & Connectors > Advanced settings, turn on developer mode, create a connector with https://mcp.deyaho.com/mcp and OAuth authentication.

Any other MCP client: the same URL over Streamable HTTP, with OAuth or the Authorization: Bearer header.

Example prompts

• "Call +34 600 000 000 on behalf of Sun Clinic and confirm tomorrow's 10:00 appointment; if it does not suit them, ask for another time. They gave consent in the booking form. Then give me the summary and the transcript."
• "Call +52 55 1234 5678 for Casa Azul Restaurant and remind them of their reservation for 4 people tonight at 21:00. They booked on our website and accepted reminder calls."
• "Call the lead who just filled in our form (+34 611 222 333, consent in the form) on behalf of Nova Dental, ask what treatment they want and when they can come, and return the answers as data."
• "Run a 3-question satisfaction survey with +52 33 9876 5432 for TallerMax (they agreed when they picked up their car) and give me each answer."
• "Use get_pricing and tell me my balance."

Tools

Tool	What it does
make_call	Calls to (E.164) on behalf of business_name, pursues goal, collects the collect fields, in language (es/en). call_purpose is service (appointments, reminders, surveys of your own customers, calls the person asked for) or commercial (selling or offering something to someone who did not ask for it). Requires consent_confirmed: true and a consent_statement. Optional website_url (the agent reads the business website before the call) and business_info. Returns call_id.
get_call	Status, duration, billed minutes, summary, collected data and full transcript.
list_calls	Your latest calls, newest first.
get_pricing	Free. Price, your balance, limits, countries and calling hours.

Pricing

0.25 USD per connected minute, rounded up to the minute. Prepaid packs: 40 min = 10 USD, 100 min = 25 USD, 200 min = 50 USD (also in EUR and MXN). No monthly fee, no number to buy. A 3-minute call costs 0.57 USD.

Limits and compliance

• Max 4 minutes per call, 10 calls per day per key, one call at a time.
• Calling hours depend on call_purpose, local time of the destination: service calls Monday to Saturday 09:00-21:00; commercial calls Monday to Friday, Spain 09:00-21:00 and Mexico 09:00-19:00. No calls on Sundays or national holidays.
• Since 17 October 2026, commercial calls to Spain must come from a 400 number. Until Deyaho has one, calls to Spain are service calls; make_call returns commercial calls to Spain require a 400 number otherwise.
• Spain and Mexico only; emergency, premium-rate and toll-free numbers are blocked.
• At the start the agent says it is an AI (EU AI Act art. 50) and that the call is recorded, and only names the business you give it.
• Only call people who requested or agreed to be contacted (Spain: prior consent for commercial calls; Mexico: REPEP).
• Voice and data are processed in the EU. Recordings are deleted after 15 days; transcript, summary and collected data after 90 days.

Self-hosting this layer

This repository contains only the MCP layer (MIT). Voice and telephony run on Deyaho's servers.

npm ci && npm run build
DEYAHO_API_BASE=https://mcp.deyaho.com PORT=8080 npm start

---

MCP de llamadas de Deyaho

Tu agente de IA (Claude, ChatGPT, Cursor) hace llamadas telefónicas reales en español a México y España. Servidor MCP remoto: tu agente llama a una herramienta con un teléfono y un objetivo, un agente de voz con IA de Deyaho hace la llamada y recibes el resumen, los datos recogidos y la transcripción.

• Endpoint: https://mcp.deyaho.com/mcp (Streamable HTTP, OAuth o API key)
• Precio: 0,25 USD por minuto conectado, telefonía incluida, sin cuota mensual. No contestadas, comunicando y buzón de voz no se cobran.
• Destinos: México (+52) y España (+34), desde números locales (Ciudad de México y Madrid)
• Guía, precios y preguntas frecuentes: https://deyaho.com/mcp

Instalación: cuenta gratis y recarga en https://app.deyaho.com/dashboard/mcp. En Claude y Claude Desktop: Ajustes > Conectores > Añadir conector personalizado con https://mcp.deyaho.com/mcp e inicio de sesión. En Claude Code: claude mcp add --transport http deyaho-llamadas https://mcp.deyaho.com/mcp --header "Authorization: Bearer dy_mcp_TU_CLAVE". En Cursor: el mcp.json de arriba. En ChatGPT: modo desarrollador y conector con la URL y OAuth.

Ejemplo: "Llama al +34 600 000 000 de parte de Clínica Sol y confirma la cita de mañana a las 10:00; si no le viene bien, pide otra hora. Me dio su consentimiento en el formulario de reserva. Después dame el resumen y la transcripción."

Herramientas: make_call (devuelve call_id; exige call_purpose (service o commercial), consent_confirmed: true y consent_statement), get_call, list_calls y get_pricing (gratis).

Precio: 0,25 USD por minuto conectado. Packs: 40 min = 10 USD, 100 min = 25 USD, 200 min = 50 USD.

Límites: 4 minutos por llamada, 10 llamadas al día por clave, una llamada a la vez. Las llamadas de servicio funcionan de lunes a sábado de 09:00 a 21:00; las comerciales, de lunes a viernes, y en España salen por número 400. Domingos y festivos nacionales, sin llamadas. El agente avisa al empezar de que es una IA y de que la llamada se graba. Llama solo a quien haya pedido o aceptado ser contactado. Grabación borrada a los 15 días; transcripción, resumen y datos a los 90.

License

MIT