Telnyx

Servidor MCP remoto oficial de Telnyx para agentes de IA.

Documentación

Telnyx AI

Este repositorio es el punto de encuentro único para Agentes de IA y desarrolladores que priorizan la IA y construyen con Telnyx: todo lo que un agente necesita para crear aplicaciones de nivel de producción y gestionar su cuenta, desde el registro hasta la financiación.

[!NOTE] Este repositorio es un trabajo en progreso bajo desarrollo activo. Mejoramos continuamente basándonos en pruebas y comentarios. ¡Se agradecen contribuciones y comentarios!

Tabla de contenidos

Plugins de Telnyx - Configura tu asistente de codificación: plugins de Telnyx Agent Skills para Claude Code y Cursor, el servidor MCP de Telnyx alojado mediante la extensión CLI de Gemini, y un plugin de proveedor de modelos de Telnyx para OpenCode.
Agent Toolkit - integra las APIs de Telnyx con frameworks de agentes populares, incluidos el Agent SDK de OpenAI, LangChain, CrewAI y el AI SDK de Vercel mediante llamadas a funciones — disponible en Python y TypeScript.
Agent Skills - proporciona a los agentes de IA contexto preciso y actualizado sobre las APIs y SDKs de Telnyx, además de habilidades de gestión de cuentas para registro y pagos (ACP, MPP y financiación de cuentas x402).
Agent CLI - aprovisiona y construye sobre la infraestructura de Telnyx con un solo comando.
Model Context Protocol (MCP) - usa el proxy MCP de API genérica de Telnyx o las MCP Apps de capa de aplicación.
Guías - tutoriales paso a paso para flujos de trabajo comunes
Edge Compute - flujos de trabajo de agentes y herramientas de traspaso para funciones de Telnyx Edge Compute
Mantenedores - quién mantiene este repositorio y cómo contactarlos

Plugins y Extensiones

Instala los plugins de Telnyx que necesites para dar a tu asistente de codificación de IA las Telnyx Agent Skills que cubren mensajería, voz, números, IA, IoT, WebRTC, migración de Twilio, gestión de cuentas (registro, pagos ACP/MPP/x402) y más. Los plugins están divididos por área de producto para que solo cargues las habilidades que usa tu proyecto — consulta la "tabla ¿Qué plugin necesito?". Para acceso directo a la API de Telnyx desde tu asistente, añade también el servidor MCP alojado — consulta MCP.

Capacita a los agentes para generar código correcto y listo para producción — y para gestionar sus propias cuentas — sin depender de preentrenamiento o recuperación de documentación frágil.

Plugin de Claude Code

Paso 1. Añade el marketplace de Telnyx (configuración única):

/plugin marketplace add team-telnyx/ai

Paso 2. Instala los plugins que necesites — elige uno o más:

/plugin install telnyx-messaging@telnyx  # SMS / MMS
/plugin install telnyx-voice@telnyx      # Voice API (call control, AMD, recording, etc.)
/plugin install telnyx-whatsapp@telnyx   # WhatsApp Business API
/plugin install telnyx-email@telnyx      # Email API
/plugin install telnyx-tts@telnyx        # Text-to-speech
/plugin install telnyx-stt@telnyx        # Speech-to-text
/plugin install telnyx-verify@telnyx     # Phone verification / 2FA
/plugin install telnyx-numbers@telnyx    # Number management, 10DLC, porting
/plugin install telnyx-webrtc@telnyx     # WebRTC and client SDKs
/plugin install telnyx-ai@telnyx         # AI inference, assistants, and Meeting Bot
/plugin install telnyx-platform@telnyx   # Account, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration

Extensión de Gemini CLI

 gemini extensions install https://github.com/team-telnyx/ai

OpenCode

Instala el plugin de Telnyx para OpenCode para añadir Telnyx como proveedor de modelos con autenticación automática y una TUI para gestionar modelos alojados.

# Local (current project only)
opencode plugin @telnyx/opencode

# Global (all projects)
opencode plugin -g @telnyx/opencode

Consulta plugins/opencode/README.md para la configuración completa.

Cursor

[!NOTE] Nota: Nuestro listado en Cursor Marketplace está pendiente.

Mientras tanto, instala las habilidades mediante la Skills CLI.

Añade el servidor MCP de Telnyx al .cursor/mcp.json de tu proyecto:

  {                                                         
    "mcpServers": {
      "telnyx": {
        "type": "http",
        "url": "https://api.telnyx.com/v2/mcp"
      }
    }
  }

Manifiesto de Agent Plugins (cualquier cliente compatible)

La raíz del repositorio también incluye un manifiesto de Agent Plugins — plugin.json + mcp.json — para que los clientes que hablen ese formato puedan instalar todo el repositorio como un solo plugin: cada skills/*/SKILL.md se agrupa automáticamente y mcp.json declara el servidor MCP de Telnyx alojado (https://api.telnyx.com/v2/mcp, Streamable HTTP).

Autenticación. Agent Plugins v1 no tiene un mecanismo de credenciales portátil — la especificación prohíbe incrustar secretos en headers/env y deja la autorización al cliente — por lo que mcp.json no incluye credenciales. Las llamadas de descubrimiento (initialize, tools/list, resources/*) funcionan sin autenticación; tools/call requiere Authorization: Bearer <TELNYX_API_KEY>. Proporciona la clave mediante la configuración de credenciales/encabezados de tu propio cliente para el servidor telnyx, o, si tu cliente no puede adjuntar encabezados a los servidores proporcionados por plugins, ejecuta el proxy @telnyx/mcp (npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY) que añade el encabezado por ti. Obtén una clave a través del portal o telnyx.com/agent-signup.md.

Arneses

Repositorios finalizados de plugins de arnés de Telnyx para integraciones con OpenClaw y Hermes:

OpenClaw

Nombre	Descripción	Enlace
Llamada de Voz	Plugin de proveedor de Llamada de Voz de Telnyx para agentes de voz en tiempo real de OpenClaw	Repositorio
Texto a Voz	Proveedor de voz TTS de Telnyx para OpenClaw — síntesis de voz de nivel operador	Repositorio
Voz a Texto	Proveedor de STT de Telnyx para transcripción de audio de OpenClaw	Repositorio
Embeddings	Proveedor de embeddings de Telnyx para búsqueda de memoria de OpenClaw	Repositorio
Inteligencia	Plugin de proveedor de inferencia de texto de IA de Telnyx para OpenClaw	Repositorio
Canal SMS	Plugin de canal de OpenClaw para SMS/MMS mediante la API de Mensajería de Telnyx	Repositorio

Hermes

Nombre	Descripción	Enlace
Inteligencia	Plugin de proveedor de inferencia de texto de IA de Telnyx para Hermes	Repositorio
Texto a Voz	Plugin de proveedor de voz TTS de Telnyx para Hermes — streaming WebSocket, NaturalHD y voces KokoroTTS	Repositorio
Voz a Texto	Plugin de proveedor de transcripción STT de Telnyx para Hermes — reconocimiento de voz en streaming	Repositorio
SMS	Adaptador de plataforma SMS/MMS de Telnyx para Hermes Agent	Repositorio

El soporte de llamadas de voz de Hermes está en progreso y se añadirá una vez finalizado.

Agent Toolkit

Integra las APIs de Telnyx con frameworks de agentes populares mediante llamadas a funciones — disponible en Python y TypeScript.

Python

pip install telnyx-agent-toolkit

from telnyx_agent_toolkit.openai.toolkit import TelnyxAgentToolkit

toolkit = TelnyxAgentToolkit(
    api_key="KEY_...",
    configuration={
        "actions": {
            "messaging": {"send_sms": True},
            "numbers": {"search_phone_numbers": True, "buy_phone_number": True}
        }
    }
)

tools = toolkit.get_openai_tools()

Funciona con el Agent SDK de OpenAI, LangChain y CrewAI. Consulta la documentación de Python para uso completo y ejemplos.

TypeScript

npm install @telnyx/agent-toolkit

import { TelnyxAgentToolkit } from "@telnyx/agent-toolkit/langchain";

const toolkit = new TelnyxAgentToolkit(process.env.TELNYX_API_KEY!, {
  configuration: {
    actions: {
      messaging: { send_sms: true },
      numbers: { search_phone_numbers: true, buy_phone_number: true },
    },
  },
});

const tools = toolkit.getLangChainTools();

Funciona con LangChain y el AI SDK de Vercel. Consulta la documentación de TypeScript para uso completo.

Agent Skills

Instala habilidades individuales para tu asistente de codificación mediante la Skills CLI:

npx skills add team-telnyx/ai --skill <SKILL> --agent <AGENT>

Las habilidades cubren dos áreas: construir con Telnyx (mensajería, voz, números, inferencia de IA, WebRTC, migración de Twilio y más) y gestión de cuentas (registro programático, además de financiar una cuenta mediante pagos ACP, MPP o x402).

Las habilidades también se publican en telnyx.com para descubrimiento en tiempo de ejecución en /.well-known/agent-skills/index.json.

[!NOTE] Consulta Skills para instrucciones completas de instalación y una lista exhaustiva de habilidades disponibles

Agent CLI

Comandos compuestos que reducen flujos de trabajo de Telnyx de varios pasos a un solo comando. Diseñado para agentes de IA y desarrolladores que quieren aprovisionar infraestructura sin orquestar múltiples llamadas a la API.

telnyx-agent setup-sms        # Buy number + create messaging profile + assign
telnyx-agent setup-voice       # Create SIP connection + buy number + assign
telnyx-agent setup-ai          # Create AI assistant + buy number + wire together
telnyx-agent setup-porting     # Check portability + create porting order + submit
telnyx-agent status            # Account health overview

Cada comando admite --json para salida legible por máquina.

Consulta Agent CLI

Model Context Protocol (MCP)

Telnyx aloja un servidor MCP remoto en https://api.telnyx.com/v2/mcp.

Para ejecutar un servidor MCP local de Telnyx usando npx:

npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY

Consulta MCP para más detalles sobre el proxy MCP de API genérica.

MCP Apps

tools/mcp-apps contiene servidores MCP de capa de aplicación con recursos de interfaz de MCP Apps para flujos de trabajo enfocados de Telnyx. Estos son separados del proxy @telnyx/mcp genérico anterior.

Aplicaciones actuales:

Number Intelligence (tools/mcp-apps/apps/number-intelligence)
Usage & Cost Explorer (tools/mcp-apps/apps/usage-cost-explorer)
Voice Monitor (tools/mcp-apps/apps/voice-monitor)

Desde tools/mcp-apps, usa npm install, npm run typecheck, npm run build y npm test.

Guías

Guías operativas centradas en curl para flujos de trabajo comunes de Telnyx — mensajería SMS, control de llamadas de voz, asistentes de IA, números de teléfono, portabilidad, verificación, webhooks, registro 10DLC, redes WireGuard, pagos de cuenta ACP, MPP y x402, y patrones de traspaso de Edge Compute.

Consulta Guías para la lista completa.

Edge Compute

Usa este repositorio para flujos de trabajo de agentes contra Telnyx Edge Compute: el Agent CLI incluye edge-doctor (comprobaciones de preparación), setup-edge-mcp y setup-edge-webhook para conectar una función desplegada en flujos MCP y webhooks — la guía de Edge Compute recorre el flujo de trabajo completo, desde la autenticación hasta un endpoint en vivo.

Para crear, desplegar y gestionar las funciones en sí (secretos, enlaces, ciclo de vida), usa la CLI telnyx-edge de team-telnyx/edge-compute. Para flujos de agentes, prefiere autenticación con clave de API (telnyx-edge auth api-key set <key>).

Mantenedores

Mantenido por el equipo Telnyx AI‑FDE: @aisling404, @Oliver-Zimmerman, @aaronjo-Telnyx y @gbattistel (consulta CODEOWNERS). La forma más rápida de contactarnos es un issue; para informes de seguridad, consulta SECURITY.md.

Licencia

MIT