@ktmcp-cli/telnyx 1.0.0

package/AGENT.md

@@ -0,0 +1,82 @@
+# AGENT.md — Telnyx CLI for AI Agents
+
+This document explains how to use the Telnyx CLI as an AI agent.
+
+## Overview
+
+The `telnyx` CLI provides access to Telnyx's communications platform API. Use it to send SMS, make calls, manage phone numbers, and verify users.
+
+## Prerequisites
+
+```bash
+telnyx config set --api-key <key>
+```
+
+Get API key from: https://portal.telnyx.com/#/app/api-keys
+
+## All Commands
+
+### Config
+
+```bash
+telnyx config set --api-key <key>
+telnyx config show
+```
+
+### Messages
+
+```bash
+telnyx messages send --from +1XXX --to +1YYY --text "Hello"
+telnyx messages list
+telnyx messages list --json
+telnyx messages get <id>
+```
+
+### Numbers
+
+```bash
+telnyx numbers list
+telnyx numbers list --json
+telnyx numbers get <id>
+telnyx numbers search --country US
+telnyx numbers order +12125551234
+```
+
+### Calls
+
+```bash
+telnyx calls create --to +1YYY --from +1XXX
+telnyx calls hangup <call-control-id>
+telnyx calls speak <call-control-id> --text "Hello"
+```
+
+### Verify
+
+```bash
+telnyx verify send --to +1XXX               # Send SMS code
+telnyx verify send --to +1XXX --type call   # Voice call code
+telnyx verify check <id> --code 123456      # Verify the code
+telnyx verify list
+```
+
+### Connections
+
+```bash
+telnyx connections list
+telnyx connections get <id>
+```
+
+### Profiles
+
+```bash
+telnyx profiles list
+telnyx profiles get <id>
+```
+
+## Tips for Agents
+
+1. Always use `--json` when parsing results programmatically
+2. Phone numbers must be in E.164 format: `+12025551234`
+3. The `call-control-id` from `calls create` is used for call actions
+4. Verification IDs from `verify send` are needed for `verify check`
+5. Use `numbers search` before `numbers order` to find available numbers

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 KTMCP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+![Banner](https://raw.githubusercontent.com/ktmcp-cli/telnyx/main/banner.svg)
+
+> "Six months ago, everyone was talking about MCPs. And I was like, screw MCPs. Every MCP would be better as a CLI."
+>
+> — [Peter Steinberger](https://twitter.com/steipete), Founder of OpenClaw
+> [Watch on YouTube (~2:39:00)](https://www.youtube.com/@lexfridman) | [Lex Fridman Podcast #491](https://lexfridman.com/peter-steinberger/)
+
+# Telnyx CLI
+
+> **⚠️ Unofficial CLI** - Not officially sponsored or affiliated with Telnyx.
+
+A production-ready command-line interface for the [Telnyx API](https://developers.telnyx.com/) — programmable communications platform. Send SMS, make calls, manage phone numbers, and verify users directly from your terminal.
+
+## Features
+
+- **Messages** — Send and receive SMS/MMS messages
+- **Phone Numbers** — List, search, and order phone numbers
+- **Calls** — Initiate and control phone calls
+- **Verify** — Send and check 2FA verification codes
+- **Connections** — Manage SIP trunks and connections
+- **Messaging Profiles** — Configure messaging settings
+- **JSON output** — All commands support `--json` for scripting
+- **Colorized output** — Clean terminal output with chalk
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/telnyx
+```
+
+## Quick Start
+
+```bash
+# Get your API key from https://portal.telnyx.com/#/app/api-keys
+telnyx config set --api-key YOUR_API_KEY
+
+# Send an SMS
+telnyx messages send --from +12025551234 --to +19175559876 --text "Hello from Telnyx CLI!"
+
+# List your phone numbers
+telnyx numbers list
+
+# Search for available numbers
+telnyx numbers search --country US --area-code 212
+```
+
+## Commands
+
+### Config
+
+```bash
+telnyx config set --api-key <key>
+telnyx config show
+```
+
+### Messages
+
+```bash
+telnyx messages send --from +1XXX --to +1YYY --text "Hello"
+telnyx messages send --from +1XXX --to +1YYY --text "Photo" --media-urls https://example.com/photo.jpg
+telnyx messages list
+telnyx messages list --json
+telnyx messages get <message-id>
+```
+
+### Phone Numbers
+
+```bash
+telnyx numbers list
+telnyx numbers list --json
+telnyx numbers get <number-id>
+telnyx numbers search --country US
+telnyx numbers search --country US --area-code 212
+telnyx numbers order +12125551234
+telnyx numbers order +12125551234 --connection-id <id>
+```
+
+### Calls
+
+```bash
+telnyx calls create --to +1YYY --from +1XXX
+telnyx calls create --to +1YYY --from +1XXX --connection-id <id>
+telnyx calls hangup <call-control-id>
+telnyx calls speak <call-control-id> --text "Hello, this is an automated message"
+telnyx calls speak <call-control-id> --text "Bonjour" --language fr-FR --voice female
+```
+
+### Verify (2FA)
+
+```bash
+telnyx verify send --to +1XXX
+telnyx verify send --to +1XXX --type sms
+telnyx verify send --to +1XXX --type call
+telnyx verify check <verification-id> --code 123456
+telnyx verify list
+```
+
+### Connections
+
+```bash
+telnyx connections list
+telnyx connections get <connection-id>
+```
+
+### Messaging Profiles
+
+```bash
+telnyx profiles list
+telnyx profiles get <profile-id>
+```
+
+## JSON Output
+
+All commands support `--json` for structured output:
+
+```bash
+telnyx numbers list --json | jq '.[].phone_number'
+telnyx messages list --json | jq '.[0]'
+```
+
+## Why CLI > MCP?
+
+No server to run. No protocol overhead. Just install and go.
+
+- **Simpler** — Just a binary you call directly
+- **Composable** — Pipe to `jq`, `grep`, `awk`
+- **Scriptable** — Works in cron jobs, CI/CD, shell scripts
+
+## License
+
+MIT — Part of the [Kill The MCP](https://killthemcp.com) project.

package/banner.svg

@@ -0,0 +1,17 @@
+<svg width="800" height="200" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0a0a0a;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#1a1a1a;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" style="stop-color:#ff6b00;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#ff9a00;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  <rect width="800" height="200" fill="url(#bgGrad)" rx="12" />
+  <text x="40" y="90" font-family="monospace" font-size="52" font-weight="bold" fill="url(#textGrad)">telnyx</text>
+  <text x="40" y="130" font-family="monospace" font-size="18" fill="#666">Communications Platform CLI</text>
+  <text x="40" y="165" font-family="monospace" font-size="14" fill="#444">npm install -g @ktmcp-cli/telnyx</text>
+  <text x="720" y="180" font-family="monospace" font-size="12" fill="#333">killthemcp.com</text>
+</svg>

package/bin/telnyx.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+import(join(__dirname, '..', 'src', 'index.js'));

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ktmcp-cli/telnyx",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for Telnyx API - SMS, calls, and phone numbers",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "telnyx": "bin/telnyx.js"
+  },
+  "keywords": [
+    "telnyx",
+    "sms",
+    "telephony",
+    "voice",
+    "phone",
+    "cli",
+    "api",
+    "ktmcp"
+  ],
+  "author": "KTMCP",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "axios": "^1.6.7",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "conf": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ktmcp-cli/telnyx.git"
+  },
+  "homepage": "https://killthemcp.com/telnyx-cli",
+  "bugs": {
+    "url": "https://github.com/ktmcp-cli/telnyx/issues"
+  }
+}

package/src/api.js

@@ -0,0 +1,157 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const BASE_URL = 'https://api.telnyx.com/v2';
+
+function getClient() {
+  const apiKey = getConfig('apiKey');
+  if (!apiKey) {
+    throw new Error('API key not configured. Run: telnyx config set --api-key YOUR_KEY');
+  }
+
+  return axios.create({
+    baseURL: BASE_URL,
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    }
+  });
+}
+
+async function request(method, path, data = null, params = null) {
+  const client = getClient();
+  try {
+    const response = await client.request({ method, url: path, data, params });
+    return response.data;
+  } catch (error) {
+    const errData = error.response?.data;
+    const msg = errData?.errors?.[0]?.detail ||
+                errData?.errors?.[0]?.title ||
+                errData?.error?.message ||
+                error.message;
+    const code = error.response?.status;
+    throw new Error(`API Error ${code}: ${msg}`);
+  }
+}
+
+// ============================================================
+// Messaging
+// ============================================================
+
+export async function sendMessage({ from, to, text, subject, mediaUrls }) {
+  const body = { from, to, text };
+  if (subject) body.subject = subject;
+  if (mediaUrls) body.media_urls = mediaUrls;
+  return await request('POST', '/messages', body);
+}
+
+export async function listMessages(params = {}) {
+  const data = await request('GET', '/messages', null, params);
+  return data.data || [];
+}
+
+export async function getMessage(id) {
+  const data = await request('GET', `/messages/${id}`);
+  return data.data || null;
+}
+
+// ============================================================
+// Phone Numbers
+// ============================================================
+
+export async function listPhoneNumbers(params = {}) {
+  const data = await request('GET', '/phone_numbers', null, params);
+  return data.data || [];
+}
+
+export async function getPhoneNumber(id) {
+  const data = await request('GET', `/phone_numbers/${id}`);
+  return data.data || null;
+}
+
+export async function searchAvailableNumbers(params = {}) {
+  const data = await request('GET', '/available_phone_numbers', null, params);
+  return data.data || [];
+}
+
+export async function orderPhoneNumber({ phoneNumber, connectionId }) {
+  const body = { phone_numbers: [{ phone_number: phoneNumber }] };
+  if (connectionId) body.connection_id = connectionId;
+  return await request('POST', '/number_orders', body);
+}
+
+// ============================================================
+// Calls
+// ============================================================
+
+export async function createCall({ to, from, connectionId, webhookUrl }) {
+  const body = { to, from };
+  if (connectionId) body.connection_id = connectionId;
+  if (webhookUrl) body.webhook_url = webhookUrl;
+  return await request('POST', '/calls', body);
+}
+
+export async function getCall(callControlId) {
+  const data = await request('GET', `/calls/${callControlId}`);
+  return data.data || null;
+}
+
+export async function hangupCall(callControlId) {
+  return await request('POST', `/calls/${callControlId}/actions/hangup`, {});
+}
+
+export async function speakText(callControlId, { payload, voice, language }) {
+  return await request('POST', `/calls/${callControlId}/actions/speak`, {
+    payload,
+    voice: voice || 'female',
+    language: language || 'en-US'
+  });
+}
+
+// ============================================================
+// Connections (SIP Trunks)
+// ============================================================
+
+export async function listConnections(params = {}) {
+  const data = await request('GET', '/connections', null, params);
+  return data.data || [];
+}
+
+export async function getConnection(id) {
+  const data = await request('GET', `/connections/${id}`);
+  return data.data || null;
+}
+
+// ============================================================
+// Verify (2FA)
+// ============================================================
+
+export async function sendVerification({ phoneNumber, type, verifyProfileId }) {
+  const body = { phone_number: phoneNumber, type: type || 'sms' };
+  if (verifyProfileId) body.verify_profile_id = verifyProfileId;
+  return await request('POST', '/verifications', body);
+}
+
+export async function verifyCode({ verificationId, code }) {
+  return await request('POST', `/verifications/${verificationId}/actions/verify`, { code });
+}
+
+export async function listVerifications(params = {}) {
+  const data = await request('GET', '/verifications', null, params);
+  return data.data || [];
+}
+
+// ============================================================
+// Messaging Profiles
+// ============================================================
+
+export async function listMessagingProfiles(params = {}) {
+  const data = await request('GET', '/messaging_profiles', null, params);
+  return data.data || [];
+}
+
+export async function getMessagingProfile(id) {
+  const data = await request('GET', `/messaging_profiles/${id}`);
+  return data.data || null;
+}

package/src/config.js

@@ -0,0 +1,33 @@
+import Conf from 'conf';
+
+const config = new Conf({
+  projectName: 'ktmcp-telnyx',
+  schema: {
+    apiKey: {
+      type: 'string',
+      default: ''
+    }
+  }
+});
+
+export function getConfig(key) {
+  return config.get(key);
+}
+
+export function setConfig(key, value) {
+  config.set(key, value);
+}
+
+export function getAllConfig() {
+  return config.store;
+}
+
+export function clearConfig() {
+  config.clear();
+}
+
+export function isConfigured() {
+  return !!config.get('apiKey');
+}
+
+export default config;

package/src/index.js

@@ -0,0 +1,683 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, isConfigured } from './config.js';
+import {
+  sendMessage,
+  listMessages,
+  getMessage,
+  listPhoneNumbers,
+  getPhoneNumber,
+  searchAvailableNumbers,
+  orderPhoneNumber,
+  createCall,
+  getCall,
+  hangupCall,
+  speakText,
+  listConnections,
+  getConnection,
+  sendVerification,
+  verifyCode,
+  listVerifications,
+  listMessagingProfiles,
+  getMessagingProfile
+} from './api.js';
+
+const program = new Command();
+
+// ============================================================
+// Helpers
+// ============================================================
+
+function printSuccess(message) {
+  console.log(chalk.green('✓') + ' ' + message);
+}
+
+function printError(message) {
+  console.error(chalk.red('✗') + ' ' + message);
+}
+
+function printTable(data, columns) {
+  if (!data || data.length === 0) {
+    console.log(chalk.yellow('No results found.'));
+    return;
+  }
+
+  const widths = {};
+  columns.forEach(col => {
+    widths[col.key] = col.label.length;
+    data.forEach(row => {
+      const val = String(col.format ? col.format(row[col.key], row) : (row[col.key] ?? ''));
+      if (val.length > widths[col.key]) widths[col.key] = val.length;
+    });
+    widths[col.key] = Math.min(widths[col.key], 40);
+  });
+
+  const header = columns.map(col => col.label.padEnd(widths[col.key])).join('  ');
+  console.log(chalk.bold(chalk.cyan(header)));
+  console.log(chalk.dim('─'.repeat(header.length)));
+
+  data.forEach(row => {
+    const line = columns.map(col => {
+      const val = String(col.format ? col.format(row[col.key], row) : (row[col.key] ?? ''));
+      return val.substring(0, widths[col.key]).padEnd(widths[col.key]);
+    }).join('  ');
+    console.log(line);
+  });
+
+  console.log(chalk.dim(`\n${data.length} result(s)`));
+}
+
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function withSpinner(message, fn) {
+  const spinner = ora(message).start();
+  try {
+    const result = await fn();
+    spinner.stop();
+    return result;
+  } catch (error) {
+    spinner.stop();
+    throw error;
+  }
+}
+
+function requireAuth() {
+  if (!isConfigured()) {
+    printError('Telnyx API key not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  telnyx config set --api-key YOUR_API_KEY'));
+    console.log('\nGet your API key from: https://portal.telnyx.com/#/app/api-keys');
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('telnyx')
+  .description(chalk.bold('Telnyx CLI') + ' - Communications platform from your terminal')
+  .version('1.0.0');
+
+// ============================================================
+// CONFIG
+// ============================================================
+
+const configCmd = program.command('config').description('Manage CLI configuration');
+
+configCmd
+  .command('set')
+  .description('Set configuration values')
+  .option('--api-key <key>', 'Telnyx API key')
+  .action((options) => {
+    if (options.apiKey) {
+      setConfig('apiKey', options.apiKey);
+      printSuccess('API key set');
+    } else {
+      printError('No options provided. Use --api-key');
+    }
+  });
+
+configCmd
+  .command('show')
+  .description('Show current configuration')
+  .action(() => {
+    const apiKey = getConfig('apiKey');
+    console.log(chalk.bold('\nTelnyx CLI Configuration\n'));
+    console.log('API Key: ', apiKey ? chalk.green(apiKey.substring(0, 8) + '...') : chalk.red('not set'));
+    console.log('');
+  });
+
+// ============================================================
+// MESSAGES
+// ============================================================
+
+const messagesCmd = program.command('messages').description('Send and manage SMS/MMS messages');
+
+messagesCmd
+  .command('send')
+  .description('Send an SMS or MMS message')
+  .requiredOption('--from <number>', 'From phone number (E.164 format, e.g. +12025551234)')
+  .requiredOption('--to <number>', 'To phone number (E.164 format)')
+  .requiredOption('--text <message>', 'Message text')
+  .option('--media-urls <urls>', 'Comma-separated media URLs (for MMS)')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const params = { from: options.from, to: options.to, text: options.text };
+      if (options.mediaUrls) params.mediaUrls = options.mediaUrls.split(',');
+
+      const result = await withSpinner('Sending message...', () => sendMessage(params));
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess(`Message sent!`);
+      console.log('Message ID:  ', chalk.cyan(result.data?.id || 'N/A'));
+      console.log('From:        ', result.data?.from?.phone_number || options.from);
+      console.log('To:          ', result.data?.to?.[0]?.phone_number || options.to);
+      console.log('Status:      ', result.data?.to?.[0]?.status || 'queued');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+messagesCmd
+  .command('list')
+  .description('List recent messages')
+  .option('--page-size <n>', 'Results per page', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const messages = await withSpinner('Fetching messages...', () =>
+        listMessages({ page_size: options.pageSize })
+      );
+
+      if (options.json) {
+        printJson(messages);
+        return;
+      }
+
+      printTable(messages, [
+        { key: 'id', label: 'ID', format: (v) => (v || '').substring(0, 12) + '...' },
+        { key: 'from', label: 'From', format: (v) => typeof v === 'object' ? v.phone_number : v },
+        { key: 'to', label: 'To', format: (v) => Array.isArray(v) ? v[0]?.phone_number : v },
+        { key: 'text', label: 'Text', format: (v) => (v || '').substring(0, 30) },
+        { key: 'direction', label: 'Direction' },
+        { key: 'created_at', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+messagesCmd
+  .command('get <message-id>')
+  .description('Get a specific message')
+  .option('--json', 'Output as JSON')
+  .action(async (messageId, options) => {
+    requireAuth();
+    try {
+      const message = await withSpinner('Fetching message...', () => getMessage(messageId));
+
+      if (!message) {
+        printError('Message not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(message);
+        return;
+      }
+
+      console.log(chalk.bold('\nMessage Details\n'));
+      console.log('ID:         ', chalk.cyan(message.id));
+      console.log('From:       ', typeof message.from === 'object' ? message.from?.phone_number : message.from);
+      console.log('To:         ', Array.isArray(message.to) ? message.to[0]?.phone_number : message.to);
+      console.log('Text:       ', message.text || 'N/A');
+      console.log('Direction:  ', message.direction);
+      console.log('Status:     ', message.to?.[0]?.status || 'N/A');
+      console.log('Created:    ', message.created_at ? new Date(message.created_at).toLocaleString() : 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// PHONE NUMBERS
+// ============================================================
+
+const numbersCmd = program.command('numbers').description('Manage phone numbers');
+
+numbersCmd
+  .command('list')
+  .description('List your phone numbers')
+  .option('--page-size <n>', 'Results per page', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const numbers = await withSpinner('Fetching phone numbers...', () =>
+        listPhoneNumbers({ page_size: options.pageSize })
+      );
+
+      if (options.json) {
+        printJson(numbers);
+        return;
+      }
+
+      printTable(numbers, [
+        { key: 'id', label: 'ID', format: (v) => (v || '').substring(0, 12) + '...' },
+        { key: 'phone_number', label: 'Phone Number' },
+        { key: 'status', label: 'Status' },
+        { key: 'country_code', label: 'Country' },
+        { key: 'type', label: 'Type' },
+        { key: 'created_at', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+numbersCmd
+  .command('get <number-id>')
+  .description('Get details for a specific phone number')
+  .option('--json', 'Output as JSON')
+  .action(async (numberId, options) => {
+    requireAuth();
+    try {
+      const number = await withSpinner('Fetching phone number...', () => getPhoneNumber(numberId));
+
+      if (!number) {
+        printError('Phone number not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(number);
+        return;
+      }
+
+      console.log(chalk.bold('\nPhone Number Details\n'));
+      console.log('ID:             ', chalk.cyan(number.id));
+      console.log('Number:         ', chalk.bold(number.phone_number));
+      console.log('Status:         ', number.status);
+      console.log('Country:        ', number.country_code || 'N/A');
+      console.log('Type:           ', number.type || 'N/A');
+      console.log('Features:       ', (number.features || []).join(', ') || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+numbersCmd
+  .command('search')
+  .description('Search available phone numbers to buy')
+  .option('--country <code>', 'Country code (e.g. US)', 'US')
+  .option('--area-code <code>', 'Area code to search in')
+  .option('--contains <digits>', 'Filter numbers containing these digits')
+  .option('--limit <n>', 'Max results', '10')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const params = {
+        country_code: options.country,
+        limit: options.limit
+      };
+      if (options.areaCode) params.national_destination_code = options.areaCode;
+      if (options.contains) params.phone_number_type = 'local';
+
+      const numbers = await withSpinner('Searching available numbers...', () =>
+        searchAvailableNumbers(params)
+      );
+
+      if (options.json) {
+        printJson(numbers);
+        return;
+      }
+
+      printTable(numbers, [
+        { key: 'phone_number', label: 'Phone Number' },
+        { key: 'region_name', label: 'Region' },
+        { key: 'phone_number_type', label: 'Type' },
+        { key: 'cost', label: 'Monthly Cost', format: (v, row) => row.cost?.monthly?.amount ? `$${row.cost.monthly.amount} ${row.cost.monthly.currency}` : 'N/A' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+numbersCmd
+  .command('order <phone-number>')
+  .description('Order a phone number')
+  .option('--connection-id <id>', 'Connection/trunk ID to assign to')
+  .option('--json', 'Output as JSON')
+  .action(async (phoneNumber, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner(`Ordering ${phoneNumber}...`, () =>
+        orderPhoneNumber({ phoneNumber, connectionId: options.connectionId })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess(`Order placed for ${chalk.bold(phoneNumber)}`);
+      console.log('Order ID:  ', result.data?.id || 'N/A');
+      console.log('Status:    ', result.data?.status || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// CALLS
+// ============================================================
+
+const callsCmd = program.command('calls').description('Make and manage phone calls');
+
+callsCmd
+  .command('create')
+  .description('Initiate a new call')
+  .requiredOption('--to <number>', 'Destination number (E.164 format)')
+  .requiredOption('--from <number>', 'Caller ID (E.164 format)')
+  .option('--connection-id <id>', 'Telnyx connection ID')
+  .option('--webhook-url <url>', 'Webhook URL for call events')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner(`Calling ${options.to}...`, () =>
+        createCall({ to: options.to, from: options.from, connectionId: options.connectionId, webhookUrl: options.webhookUrl })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess('Call initiated!');
+      console.log('Call Control ID:  ', chalk.cyan(result.data?.call_control_id || 'N/A'));
+      console.log('Call Session ID:  ', result.data?.call_session_id || 'N/A');
+      console.log('State:            ', result.data?.state || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+callsCmd
+  .command('hangup <call-control-id>')
+  .description('Hang up an active call')
+  .option('--json', 'Output as JSON')
+  .action(async (callControlId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Hanging up...', () => hangupCall(callControlId));
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+      printSuccess('Call hung up');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+callsCmd
+  .command('speak <call-control-id>')
+  .description('Speak text on an active call (text-to-speech)')
+  .requiredOption('--text <message>', 'Text to speak')
+  .option('--voice <voice>', 'Voice (female|male)', 'female')
+  .option('--language <lang>', 'Language code', 'en-US')
+  .option('--json', 'Output as JSON')
+  .action(async (callControlId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Speaking text...', () =>
+        speakText(callControlId, { payload: options.text, voice: options.voice, language: options.language })
+      );
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+      printSuccess('Text-to-speech started');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// VERIFY
+// ============================================================
+
+const verifyCmd = program.command('verify').description('Send and check 2FA verification codes');
+
+verifyCmd
+  .command('send')
+  .description('Send a verification code')
+  .requiredOption('--to <number>', 'Phone number to verify (E.164 format)')
+  .option('--type <type>', 'Delivery type (sms|call|flash)', 'sms')
+  .option('--profile-id <id>', 'Verify profile ID')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner(`Sending ${options.type.toUpperCase()} code to ${options.to}...`, () =>
+        sendVerification({ phoneNumber: options.to, type: options.type, verifyProfileId: options.profileId })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess('Verification code sent!');
+      console.log('Verification ID:  ', chalk.cyan(result.data?.id || 'N/A'));
+      console.log('Phone:            ', options.to);
+      console.log('Type:             ', options.type.toUpperCase());
+      console.log('');
+      console.log(chalk.dim('Use: telnyx verify check <verification-id> --code <code>'));
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+verifyCmd
+  .command('check <verification-id>')
+  .description('Check a verification code')
+  .requiredOption('--code <code>', 'The verification code to check')
+  .option('--json', 'Output as JSON')
+  .action(async (verificationId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Verifying code...', () =>
+        verifyCode({ verificationId, code: options.code })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      const valid = result.data?.response_code === 'accepted';
+      if (valid) {
+        printSuccess('Code verified successfully!');
+      } else {
+        printError('Code verification failed: ' + (result.data?.response_code || 'invalid'));
+        process.exit(1);
+      }
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+verifyCmd
+  .command('list')
+  .description('List recent verifications')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const verifications = await withSpinner('Fetching verifications...', () => listVerifications());
+
+      if (options.json) {
+        printJson(verifications);
+        return;
+      }
+
+      printTable(verifications, [
+        { key: 'id', label: 'ID', format: (v) => (v || '').substring(0, 12) + '...' },
+        { key: 'phone_number', label: 'Phone Number' },
+        { key: 'type', label: 'Type' },
+        { key: 'status', label: 'Status' },
+        { key: 'created_at', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// CONNECTIONS
+// ============================================================
+
+const connectionsCmd = program.command('connections').description('Manage SIP connections and trunks');
+
+connectionsCmd
+  .command('list')
+  .description('List all connections')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const connections = await withSpinner('Fetching connections...', () => listConnections());
+
+      if (options.json) {
+        printJson(connections);
+        return;
+      }
+
+      printTable(connections, [
+        { key: 'id', label: 'ID', format: (v) => (v || '').substring(0, 12) + '...' },
+        { key: 'connection_name', label: 'Name' },
+        { key: 'record_type', label: 'Type' },
+        { key: 'active', label: 'Active', format: (v) => v ? chalk.green('Yes') : 'No' },
+        { key: 'created_at', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+connectionsCmd
+  .command('get <connection-id>')
+  .description('Get a specific connection')
+  .option('--json', 'Output as JSON')
+  .action(async (connectionId, options) => {
+    requireAuth();
+    try {
+      const connection = await withSpinner('Fetching connection...', () => getConnection(connectionId));
+
+      if (!connection) {
+        printError('Connection not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(connection);
+        return;
+      }
+
+      console.log(chalk.bold('\nConnection Details\n'));
+      console.log('ID:     ', chalk.cyan(connection.id));
+      console.log('Name:   ', chalk.bold(connection.connection_name || 'N/A'));
+      console.log('Type:   ', connection.record_type || 'N/A');
+      console.log('Active: ', connection.active ? chalk.green('Yes') : 'No');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// MESSAGING PROFILES
+// ============================================================
+
+const profilesCmd = program.command('profiles').description('Manage messaging profiles');
+
+profilesCmd
+  .command('list')
+  .description('List messaging profiles')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const profiles = await withSpinner('Fetching messaging profiles...', () => listMessagingProfiles());
+
+      if (options.json) {
+        printJson(profiles);
+        return;
+      }
+
+      printTable(profiles, [
+        { key: 'id', label: 'ID', format: (v) => (v || '').substring(0, 12) + '...' },
+        { key: 'name', label: 'Name' },
+        { key: 'enabled', label: 'Enabled', format: (v) => v ? chalk.green('Yes') : 'No' },
+        { key: 'created_at', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+profilesCmd
+  .command('get <profile-id>')
+  .description('Get a specific messaging profile')
+  .option('--json', 'Output as JSON')
+  .action(async (profileId, options) => {
+    requireAuth();
+    try {
+      const profile = await withSpinner('Fetching messaging profile...', () => getMessagingProfile(profileId));
+
+      if (!profile) {
+        printError('Messaging profile not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(profile);
+        return;
+      }
+
+      console.log(chalk.bold('\nMessaging Profile Details\n'));
+      console.log('ID:       ', chalk.cyan(profile.id));
+      console.log('Name:     ', chalk.bold(profile.name || 'N/A'));
+      console.log('Enabled:  ', profile.enabled ? chalk.green('Yes') : 'No');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}