N3T Mobile CPaaS SMS MCP Server

An official Model Context Protocol (MCP) server that enables AI models (like Claude and Cursor) to interact with the N3T Mobile CPaaS Gateway to send SMS, check message delivery status, and perform Mexican Mobile Number Portability (MNP) carrier lookups.

Features

• send_sms: Send single or multi-recipient SMS messages.

• get_sms_status: Fetch the delivery state (including terminal codes) of a previously sent message.

• mnp_lookup: Retrieve Mobile Number Portability metadata (MCC, MNC, and Carrier Name) for Mexican phone numbers.

• Auto JWT Refresh: Authenticates dynamically using API client credentials and manages token expiration automatically.

Related MCP server: Twilio SMS Server

Installation

Prerequisites

• Node.js (v18.0.0 or later)

• An active API Peer account on the N3T Mobile gateway (username and password).

Local Execution

To run the server locally from this directory:

1. Install dependencies:

   npm install

2. Start the server (requires configuration env vars):

   CPAAS_BASE_URL="http://localhost:8080" \
   CPAAS_USERNAME="your_username" \
   CPAAS_PASSWORD="your_password" \
   node index.js

Configuration

Configure your AI assistant host to use the server.

Claude Desktop

Add this configuration to your claude_desktop_config.json (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "n3t-mobile-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/n3t-mobile-mcp/index.js"],
      "env": {
        "CPAAS_BASE_URL": "https://api.n3t.mobile",
        "CPAAS_USERNAME": "your_api_username",
        "CPAAS_PASSWORD": "your_api_password"
      }
    }
  }
}

Cursor / Roo Code / VS Code

Add a new MCP server in the Settings:

• Type: stdio

• Command: node /absolute/path/to/n3t-mobile-mcp/index.js

• Environment Variables:

  • CPAAS_BASE_URL: https://api.n3t.mobile

  • CPAAS_USERNAME: your_api_username

  • CPAAS_PASSWORD: your_api_password

License

MIT