# N3T Mobile CPaaS SMS MCP Server

An official [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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](https://nodejs.org/) (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:
   ```bash
   npm install
   ```
2. Start the server (requires configuration env vars):
   ```bash
   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):

```json
{
  "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