Telnyx

Servidor MCP remoto oficial da Telnyx para agentes de IA.

Documentação

Telnyx AI

Este repositório é o ponto central para Agentes de IA e desenvolvedores focados em IA que criam com a Telnyx — tudo o que um agente precisa para construir aplicações de nível de produção e gerenciar sua conta, desde o cadastro até o financiamento.

[!NOTE] Este repositório é um trabalho em andamento sob desenvolvimento ativo. Estamos melhorando continuamente com base em testes e feedback. Contribuições e feedback são bem-vindos!

Sumário

Plugins Telnyx - Configure seu assistente de codificação: plugins Telnyx Agent Skills para Claude Code e Cursor, o servidor MCP Telnyx hospedado via extensão Gemini CLI, e um plugin de provedor de modelo Telnyx para OpenCode.
Agent Toolkit - integre APIs Telnyx com frameworks populares de agentes, incluindo o Agent SDK da OpenAI, LangChain, CrewAI e o AI SDK da Vercel por meio de function calling — disponível em Python e TypeScript.
Agent Skills - forneça a agentes de IA contexto preciso e atualizado sobre APIs e SDKs Telnyx, além de habilidades de gerenciamento de conta para cadastro e pagamentos (financiamento de conta MPP e x402).
Agent CLI - provisione e construa na infraestrutura Telnyx com um único comando.
Model Context Protocol (MCP) - use o proxy MCP de API genérica da Telnyx ou MCP Apps na camada de aplicação.
Guias - tutoriais passo a passo para fluxos de trabalho comuns
Edge Compute - fluxos de trabalho de agentes e ferramentas de handoff para funções Telnyx Edge Compute
Mantenedores - quem mantém este repositório e como contatá-los

Plugins e Extensões

Instale os plugins Telnyx necessários para dar ao seu assistente de codificação de IA as Telnyx Agent Skills cobrindo mensagens, voz, números, IA, IoT, WebRTC, migração Twilio, gerenciamento de conta (cadastro, pagamentos MPP/x402) e muito mais. Os plugins são divididos por área de produto para que você carregue apenas as habilidades que seu projeto usa — veja a "tabela de qual plugin eu preciso?". Para acesso direto à API Telnyx pelo seu assistente, adicione também o servidor MCP hospedado — veja MCP.

Capacita agentes a gerar código correto e pronto para produção — e a gerenciar suas próprias contas — sem depender de pré-treinamento ou recuperação frágil de documentos.

Plugin Claude Code

Passo 1. Adicione o marketplace Telnyx (configuração única):

/plugin marketplace add team-telnyx/ai

Passo 2. Instale os plugins necessários — escolha um ou mais:

/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

Extensão Gemini CLI

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

OpenCode

Instale o plugin Telnyx para OpenCode para adicionar a Telnyx como provedor de modelo com autenticação automática e uma TUI para gerenciar modelos hospedados.

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

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

Veja plugins/opencode/README.md para configuração completa e definições.

Cursor

[!NOTE] Nota: Nossa listagem no Cursor Marketplace está pendente.

Enquanto isso, instale as habilidades via Skills CLI.

Adicione o servidor MCP Telnyx ao .cursor/mcp.json do seu projeto:

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

Manifesto Agent Plugins (qualquer cliente compatível)

A raiz do repositório também contém um manifesto Agent Plugins — plugin.json + mcp.json — para que clientes que falam esse formato possam instalar o repositório inteiro como um único plugin: cada skills/*/SKILL.md é agrupado automaticamente e mcp.json declara o servidor MCP Telnyx hospedado (https://api.telnyx.com/v2/mcp, Streamable HTTP).

Autenticação. O Agent Plugins v1 não possui mecanismo portátil de credenciais — a especificação proíbe incorporar segredos em headers/env e deixa a autorização para o cliente — portanto, mcp.json não inclui credenciais. Chamadas de descoberta (initialize, tools/list, resources/*) funcionam sem autenticação; tools/call requer Authorization: Bearer <TELNYX_API_KEY>. Forneça a chave por meio das configurações de credenciais/cabeçalhos do seu próprio cliente para o servidor telnyx, ou, se o seu cliente não puder anexar cabeçalhos a servidores fornecidos por plugins, execute o proxy @telnyx/mcp (npx -y @telnyx/mcp --api-key=YOUR_TELNYX_API_KEY), que adiciona o cabeçalho para você. Obtenha uma chave pelo portal ou telnyx.com/agent-signup.md.

Harnesses

Repositórios finalizados de plugins harness Telnyx para integrações OpenClaw e Hermes:

OpenClaw

Nome	Descrição	Link
Voice Call	Plugin de provedor de chamadas de voz com prioridade Telnyx para agentes de voz em tempo real OpenClaw	Repositório
Text-to-Speech	Provedor de fala TTS Telnyx para OpenClaw — síntese de voz de nível operadora	Repositório
Speech-to-Text	Provedor STT Telnyx para transcrição de áudio OpenClaw	Repositório
Embeddings	Provedor de embeddings Telnyx para busca de memória OpenClaw	Repositório
Intelligence	Plugin de provedor de inferência de texto IA Telnyx para OpenClaw	Repositório
SMS Channel	Plugin de canal OpenClaw para SMS/MMS via API de Mensagens Telnyx	Repositório

Hermes

Nome	Descrição	Link
Intelligence	Plugin de provedor de inferência de texto IA Telnyx para Hermes	Repositório
Text-to-Speech	Plugin de provedor de fala TTS Telnyx para Hermes — streaming WebSocket, vozes NaturalHD e KokoroTTS	Repositório
Speech-to-Text	Plugin de provedor de transcrição STT Telnyx para Hermes — reconhecimento de fala em streaming	Repositório
SMS	Adaptador de plataforma SMS/MMS Telnyx para Hermes Agent	Repositório

O suporte a chamadas de voz Hermes está em andamento e será adicionado quando finalizado.

Agent Toolkit

Integre APIs Telnyx com frameworks populares de agentes por meio de function calling — disponível em Python e 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 com o Agent SDK da OpenAI, LangChain e CrewAI. Veja documentação Python para uso completo e exemplos.

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 com LangChain e o AI SDK da Vercel. Veja documentação TypeScript para uso completo.

Agent Skills

Instale habilidades individuais para seu assistente de codificação via Skills CLI:

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

As habilidades cobrem duas áreas: construção com Telnyx (mensagens, voz, números, inferência de IA, WebRTC, migração Twilio e muito mais) e gerenciamento de conta (cadastro programático, além de financiamento de conta via pagamentos MPP ou x402).

As habilidades também são publicadas em telnyx.com para descoberta em tempo de execução em /.well-known/agent-skills/index.json.

[!NOTE] Veja Skills para instruções completas de instalação e uma lista abrangente de habilidades disponíveis

Agent CLI

Comandos compostos que reduzem fluxos de trabalho Telnyx de várias etapas a um único comando. Criado para agentes de IA e desenvolvedores que desejam provisionar infraestrutura sem orquestrar múltiplas chamadas de 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

Todo comando suporta --json para saída legível por máquina.

Veja Agent CLI

Model Context Protocol (MCP)

A Telnyx hospeda um servidor MCP remoto em https://api.telnyx.com/v2/mcp.

Para executar um servidor MCP Telnyx local usando npx:

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

Veja MCP para mais detalhes sobre o proxy MCP de API genérica.

MCP Apps

tools/mcp-apps contém servidores MCP na camada de aplicação com recursos de UI MCP Apps para fluxos de trabalho Telnyx focados. Eles são separados do proxy @telnyx/mcp genérico acima.

Apps atuais:

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)

De tools/mcp-apps, use npm install, npm run typecheck, npm run build e npm test.

Guias

Guias operacionais com foco em curl para fluxos de trabalho Telnyx comuns — mensagens SMS, controle de chamadas de voz, assistentes de IA, números de telefone, portabilidade, verificação, webhooks, registro 10DLC, rede WireGuard, pagamentos de conta MPP e x402 e padrões de handoff Edge Compute.

Veja Guias para a lista completa.

Edge Compute

Use este repositório para fluxos de trabalho de agentes contra Telnyx Edge Compute: o Agent CLI inclui edge-doctor (verificações de prontidão), setup-edge-mcp e setup-edge-webhook para conectar uma função implantada a fluxos MCP e webhook — o guia Edge Compute percorre o fluxo de trabalho completo, desde a autenticação até um endpoint ativo.

Para criar, implantar e gerenciar as próprias funções (segredos, bindings, ciclo de vida), use o CLI telnyx-edge de team-telnyx/edge-compute. Para fluxos de agentes, prefira autenticação por chave de API (telnyx-edge auth api-key set <key>).

Mantenedores

Mantido pela equipe Telnyx AI‑FDE: @aisling404, @Oliver-Zimmerman, @aaronjo-Telnyx e @gbattistel (veja CODEOWNERS). A maneira mais rápida de nos contatar é por meio de uma issue; para relatórios de segurança, veja SECURITY.md.

Licença

MIT