Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Telnyx con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Deja que tu IA trabaje con Telnyx: consulta saldo y consumo, lista y busca números de teléfono, envía SMS y MMS, haz llamadas que leen un mensaje, revisa grabaciones de llamadas y registros detallados, consulta números, envía y comprueba códigos de un solo uso con Verify y revisa tus asistentes de IA.
Prueba a pedir
Prompts de ejemplo para Telnyx
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Telnyx, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Telnyx + ChatGPT
Deja que tu IA trabaje con Telnyx: consulta saldo y consumo, lista y busca números de teléfono, envía SMS y MMS, haz llamadas que leen un mensaje, revisa grabaciones de llamadas y registros detallados, consulta números, envía y comprueba códigos de un solo uso con Verify y revisa tus asistentes de IA.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
TELNYX_API_KEY
Paso 1 — Obtener credenciales
- Inicia sesión en el Mission Control Portal en
https://portal.telnyx.com. - Abre Account settings → Keys & Credentials → API Keys y haz clic en Create API Key. La clave empieza por
KEYy Telnyx solo la muestra una vez. - Pégala en
TELNYX_API_KEYtal como la muestra Telnyx, sin la palabra Bearer, e instala el conector. La clave solo se envía a api.telnyx.com. - Comprueba la configuración con
telnyx_get_balance: es gratis y muestra tu saldo, el límite de crédito y la moneda.
Quién ve qué: la clave actúa para toda la cuenta de Telnyx, saldo incluido. Comparte el servidor MCP solo con personas que puedan gastar dinero en ella.
Cuesta dinero y llega a personas reales, así que la IA pregunta antes: Telnyx cobra telnyx_send_message (SMS y MMS), telnyx_dial_call (por minuto), telnyx_speak_text (texto a voz) y telnyx_send_verification (por verificación). Antes de cada una, la IA te muestra el destinatario, el remitente y el contenido y espera tu sí. telnyx_lookup_number se cobra por consulta, así que la IA te avisa antes de consultar muchos números. Enviar, llamar y comprar requieren una cuenta con saldo.
Desactivada al instalar: telnyx_order_phone_numbers, que compra números con un precio inicial y una cuota mensual por número. Un administrador la activa de forma deliberada; después la IA muestra cada número con sus costes y solo compra cuando lo confirmas. Buscar números con telnyx_search_available_numbers es gratis.
SMS: un número solo envía SMS si está asignado a un messaging profile (telnyx_list_messaging_profiles muestra los perfiles y los países a los que cada uno puede enviar). Un mensaje nuevo empieza como queued; más tarde telnyx_get_message muestra el estado de entrega por destinatario. Con enlaces a archivos multimedia el mensaje se convierte en MMS (EE. UU. y Canadá).
Las llamadas necesitan una Call Control application: crea una en el Mission Control Portal y asígnale el número desde el que llamas. telnyx_list_call_control_applications da el connection_id que necesita telnyx_dial_call. La IA marca, comprueba con telnyx_get_call_status hasta que contestan, lee tu mensaje con telnyx_speak_text y cuelga con telnyx_hangup_call. Un límite de tiempo en la llamada pone tope al coste. Los eventos de la llamada van a la URL de webhook de la application, que este conector no recibe. Grabaciones: telnyx_list_recordings y telnyx_get_recording (los enlaces de descarga caducan a los pocos minutos).
Verify: crea una vez un Verify profile en el portal, en Verify; telnyx_list_verify_profiles lo lista. telnyx_send_verification envía un código por SMS, llamada de voz o WhatsApp, y telnyx_check_verification_code comprueba lo que escribió la persona.
Consumo y costes: telnyx_search_detail_records lista mensajes y llamadas sueltos con su coste; telnyx_get_usage_report_options y telnyx_get_usage_report dan los totales por producto de hasta 31 días. Los asistentes de IA son de solo lectura: telnyx_list_ai_assistants y telnyx_get_ai_assistant.
Números: siempre en E.164, es decir, +, el prefijo del país y el número sin espacios (+34612345678).
Errores comunes: 401 (10009): la clave es incorrecta, se borró o se pegó con un prefijo; crea una nueva en el portal. 403: la cuenta aún no puede usar esta función (por ejemplo, enviar a un país o comprar números antes de verificar la cuenta), o a la clave le falta el permiso. 404 (10005): ese recurso no existe en esta cuenta. 422: un parámetro no es válido, por ejemplo el remitente no tiene messaging profile, la llamada aún no se ha contestado o un número no está en E.164. 429: demasiadas peticiones; espera y vuelve a intentarlo.
El conector no cubre la portabilidad de números, la configuración y liberación de números, SIP trunking, TeXML, conferencias, fax, plantillas de WhatsApp, el registro 10DLC de marcas y campañas, la creación o modificación de asistentes de IA ni los webhooks.
Paso 2 — Instalar el adapter
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
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Telnyx. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
Ejemplos de prompts
- "¿Cuál es nuestro saldo en Telnyx y cuánto hemos gastado en mensajes este mes, por país?"
- "Envía un SMS desde nuestro número de Madrid al +34612345678 diciendo que el pedido está listo para recoger. Muéstrame antes remitente, destinatario y texto."
- "Llama al +34612345678 desde nuestra línea de soporte, di que el técnico llega a las 15:00 y cuelga. Que la llamada no pase de un minuto."
- "Busca tres números móviles en España que puedan enviar SMS y muéstrame el coste inicial y mensual de cada uno."
- "¿Qué mensajes de ayer no se entregaron? Revisa los registros detallados y muéstrame el estado y el coste."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
¿Te ha sido útil esta guía?
