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 el financiamiento.

[!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 (financiamiento de cuentas MPP y 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 darle 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 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, agrega 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 ni de recuperación frágil de documentos.

Plugin de Claude Code

Paso 1. Agrega 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 CLI de Gemini

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

OpenCode

Instala el plugin de Telnyx para OpenCode para agregar a 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 el Marketplace de Cursor está pendiente.

Mientras tanto, instala las habilidades mediante la CLI de Skills.

Agrega 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 el plugin, ejecuta el proxy @telnyx/mcp (npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY), que agrega el encabezado por ti. Obtén una clave a través del portal o de 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 llamadas de voz con prioridad 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: transmisión por WebSocket, voces NaturalHD y KokoroTTS	Repositorio
Voz a texto	Plugin de proveedor de transcripción STT de Telnyx para Hermes: reconocimiento de voz en transmisión	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 agregará 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 el uso completo y los 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 el uso completo.

Agent Skills

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

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 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 las 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 con 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 UI de MCP Apps para flujos de trabajo enfocados de Telnyx. Estos son independientes del proxy @telnyx/mcp genérico anterior.

Apps 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 con prioridad 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 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: la Agent CLI incluye edge-doctor (verificaciones de preparación), setup-edge-mcp y setup-edge-webhook para conectar una función desplegada a flujos de 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 la 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 mediante un issue; para informes de seguridad, consulta SECURITY.md.

Licencia

MIT