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.
---
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:
- Install dependencies:
npm install- 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.mobileCPAAS_USERNAME:your_api_usernameCPAAS_PASSWORD:your_api_password
---
License
MIT
