Twilio a MCP: Pilota Twilio desde cualquier agente IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Twilio, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Twilio

Deja que tu IA trabaje con Twilio: envía y consulta mensajes SMS y de WhatsApp, revisa llamadas y números de teléfono, comprueba números con Lookup, envía y verifica códigos de un solo uso con Verify y controla el uso, los costes y el saldo.

Configuración

1. Inicia sesión en console.twilio.com. El panel Account Info de la página de inicio muestra el Account SID (empieza por AC) y el Auth Token.
2. Recomendado: crea una API key en lugar de usar el Auth Token. En la Console abre Settings → Account settings → API keys & auth tokens (en la Console antigua Admin → Account management → API keys & tokens), haz clic en Create API key, elige el tipo Standard y copia el SID (empieza por SK) y el Secret: Twilio muestra el secret una sola vez. Puedes revocar una key por separado sin cambiar el Auth Token.
3. Pega el Account SID en TWILIO_ACCOUNT_SID. Después, o bien pon el SID de la key (SK...) en TWILIO_API_KEY_SID y su secret en TWILIO_API_KEY_SECRET, o bien vuelve a poner el Account SID (AC...) en TWILIO_API_KEY_SID y el Auth Token en TWILIO_API_KEY_SECRET.
4. Instala el conector y empieza con twilio_list_phone_numbers: lista los números que tienes, es decir, los remitentes que puede usar la IA. Una API key Standard no puede leer el registro de la propia cuenta, así que con ella twilio_get_account puede responder 401 o 403; todas las demás herramientas funcionan.

Enviar cuesta dinero y llega a personas reales: twilio_send_message y twilio_send_verification envían un mensaje o un código real a una persona real, y Twilio cobra cada envío. Antes, la IA indica destinatario, remitente, canal y texto y espera tu confirmación. Lo mismo vale para twilio_cancel_scheduled_message.

Desactivadas al instalar: twilio_delete_message, que borra para siempre el registro de un mensaje junto con su texto. Actívala solo si la IA debe borrar mensajes.

Cuentas de prueba (trial): una cuenta trial solo envía a un máximo de cinco números verificados (si no, error 21608) y solo dentro del país en el que te registraste. En trial, un SMS enviado por la API solo puede usar como texto una de las plantillas de ejemplo de Twilio (como sms_2fa o sms_appointment_reminders); el texto libre requiere una cuenta actualizada.

WhatsApp: pon whatsapp: delante de ambos números (whatsapp:+4915112345678). Para una primera prueba usa el WhatsApp Sandbox de la Console antigua: la persona envía join <code> al número del sandbox y después puedes escribirle desde whatsapp:+14155238886 durante tres días. Pasadas 24 horas desde su último mensaje, WhatsApp solo entrega plantillas aprobadas, enviadas con content_sid (HX...) y content_variables (si no, error 63016).

Números: siempre en E.164, es decir, +, el prefijo del país y el número sin espacios (+4915112345678). twilio_list_phone_numbers muestra los números desde los que puedes enviar; twilio_list_messaging_services lista tus Messaging Services, que necesitas para los mensajes programados (schedule_type fixed con send_at).

Estado de entrega: un mensaje nuevo empieza como queued. Pide a la IA que lo compruebe más tarde con twilio_get_message: failed o undelivered llegan con un error_code que puedes buscar en la lista de errores de Twilio. twilio_list_messages y twilio_list_calls muestran el historial, del más reciente al más antiguo.

Lookup: twilio_lookup_phone_number sin fields es gratuito y comprueba el formato y el país. Cada paquete de datos en fields (como line_type_intelligence, sms_pumping_risk o caller_name) se cobra por consulta, así que la IA pregunta antes.

Verify: crea una vez un servicio de Verify en la Console (Verify → Services → Create new); twilio_list_verify_services muestra su sid VA.... twilio_send_verification envía el código por SMS, llamada de voz, WhatsApp o email, y twilio_check_verification comprueba lo que ha escrito la persona (estado approved si es correcto). Cada verificación aprobada cuesta unos 0,05 USD más la tarifa del canal.

Uso y costes: twilio_list_usage_records abarca un rango de fechas, twilio_list_usage_records_by_period lo divide por día, mes o año o usa una ventana como ThisMonth. La categoría totalprice es tu gasto total; twilio_get_balance muestra el saldo restante.

Paginación: las listas devuelven next_page_uri (null en la última página); para la página siguiente, la IA pasa los valores page y page_token que contiene.

Errores frecuentes: 401 o 20003 significa un SID o secret incorrecto, o una API key usada con un Account SID al que no pertenece. 404 o 20404 significa que en esta cuenta no existe ese mensaje, llamada, número o servicio. 21211 es un número to no válido, 21606 un número from que no es un número de Twilio de esta cuenta o no puede enviar SMS, 21610 un destinatario que respondió STOP. 429 o 20429 significa demasiadas solicitudes: espera y vuelve a intentarlo.

El conector no realiza llamadas, no compra ni configura números y no gestiona Conversations, Studio, Flex, Voice TwiML ni webhooks.

Requisitos previos: TWILIO_ACCOUNT_SID, TWILIO_API_KEY_SID, TWILIO_API_KEY_SECRET

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Twilio e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "Muéstrame los mensajes SMS y de WhatsApp que enviamos hoy y marca los que fallaron o no se entregaron, con el código de error."
• "¿Cuánto hemos gastado en Twilio este mes por categoría y cuánto saldo nos queda?"
• "Comprueba si +4915112345678 es un número válido y a qué país pertenece."
• "Envía un SMS desde nuestro número de Twilio a +4915112345678 para avisar al cliente de que el pedido 1042 ya está enviado y llega mañana."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT