barryreynolds1/messaging-tools-mcp

messaging-tools-mcp

Complete messaging tools MCP (Model Context Protocol) server providing unified access to Telnyx messaging services.

Overview

This comprehensive MCP server provides 183 tools across 4 messaging services:

• messaging-settings-data (43 tools) - Numbers, profiles, users, SMPP, RCS bots, spend limits
• messaging-campaign-registry (95 tools) - Brand & campaign management, 10DLC operations
• netnumbers (9 tools) - Number lookups and OSR management
• messaging-2fa (36 tools) - 2FA verification profiles and workflows

Regenerating this Server

To regenerate this MCP server with updated OpenAPI specifications, use the following command:

npx openapi-mcp-generator \
  --input http://messaging-settings-data.query.prod.telnyx.io/openapi.json \
           http://messaging-campaign-registry.query.prod.telnyx.io/openapi.json \
           http://netnumbers.query.prod.telnyx.io:8000/openapi.json \
           http://messaging-2fa.query.consul:1417/openapi.json \
  --output /workspaces/messaging-tools-mcp \
  --server-name messaging-tools-mcp \
  --transport stdio \
  --force

Note: Make sure to backup any custom changes before regenerating.

Getting Started

Local Development

1. Install dependencies: npm install
2. Build the code: npm run build
3. Run the server:
   • For stdio transport (MCP client): npm run start:stdio
   • For HTTP transport (web access): npm run start:web

Docker Deployment

1. Build Docker image: npm run docker:build
2. Run container: npm run docker:run
3. Access at: http://localhost:8000

Kubernetes Deployment

1. Apply manifests: ./deploy.sh
2. Access at: http://messaging-tools-mcp.query.prod.telnyx.io:8000

Endpoints

• /health - Health check endpoint
• / - Server information
• /mcp - MCP protocol endpoint (POST)

Documentation

For more detailed information, see the documentation in the generator repository:

• Setup Guide - Complete setup instructions for local development
• Programmatic API - Use the generator programmatically in your Node.js applications
• Docker/Podman Guide - Container-based setup and deployment
• Deployment Guide - Deploy generated services to DEV and PROD environments

Generated with: https://github.com/team-telnyx/typescript-openapi-mcp-generator