# Twilio Messaging Mcp Server

> MCP server from deshartman/twilio-messaging-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-deshartman-twilio-messaging-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [deshartman](https://agentstack.voostack.com/s/deshartman)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [deshartman](https://github.com/deshartman)
- **Source:** https://github.com/deshartman/twilio-messaging-mcp-server

## Install

```sh
agentstack add mcp-deshartman-twilio-messaging-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Twilio Messaging MCP Server

An MCP server for sending SMS messages via Twilio API. This server provides tools, resources, and prompts for interacting with the Twilio Messaging API.

## Features

- Send SMS messages via Twilio
- Get status callbacks from Twilio with enhanced handling via `@deshartman/mcp-status-callback`
- Integrates with Claude AI via the Model Context Protocol (MCP)
- Executable via npx for easy usage without installation

## Prerequisites

- Node.js >= 18.0.0
- Twilio account with:
  - Account SID
  - API Key and Secret
  - Twilio phone number
- ngrok account with:
  - Auth token
  - Custom domain (optional)

## Installation

```bash
npm install @deshartman/twilio-messaging-mcp-server
```

Or run directly with npx:

```bash
npx @deshartman/twilio-messaging-mcp-server    
```

### NPX Usage

The package can be executed directly using npx without installation:

```bash
# Run with required parameters
npx @deshartman/twilio-messaging-mcp-server    

# With environment variables for ngrok
env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server    
```

This is possible because the package includes the "bin" field in package.json, making it executable via npx.

## Environment Variables

- `NGROK_AUTH_TOKEN`: Your ngrok authentication token (required for callback handling)
- `NGROK_CUSTOM_DOMAIN`: Your custom ngrok domain (optional)

## Usage

### Running the Server

You can run the server using the provided script with a `.env` file:

```bash
# Create a .env file with your credentials
# See .env.example for the required format

# Run the server (no arguments needed)
./run-server.sh
```

The `.env` file should contain:

```
ACCOUNT_SID=YOUR_ACCOUNT_SID
API_KEY=YOUR_API_KEY
API_SECRET=YOUR_API_SECRET
TWILIO_NUMBER=YOUR_TWILIO_PHONE_NUMBER
NGROK_AUTH_TOKEN=YOUR_NGROK_AUTH_TOKEN
NGROK_CUSTOM_DOMAIN=your-domain.ngrok.dev
```

This approach improves security by keeping credentials out of command history and simplifies the execution process.

### Directly with Node.js

```bash
env NGROK_AUTH_TOKEN=your_ngrok_auth_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev node build/index.js    
```

## MCP Integration

This server provides the following MCP capabilities:

### Tools

- `send-sms`: Send an SMS message via Twilio with server readiness validation

### Resources

- `twilio://statuscallback`: Get the last raw status callback data from Twilio with enhanced error handling

### Prompts

- `SendSMS`: Prompt for sending an SMS using Twilio Messaging MCP Server

## Troubleshooting

### ngrok Tunnel Issues

If you encounter an error like:

```
failed to start tunnel: The endpoint 'https://your-domain.ngrok.dev' is already online.
```

You have a few options:

1. Stop your existing endpoint first
2. Use a different domain name
3. Start both endpoints with `--pooling-enabled` to load balance between them

### ENOTEMPTY Error

If you encounter an npm error like:

```
npm ERR! code ENOTEMPTY
npm ERR! syscall rename
```

Try running the server directly with Node.js instead of using npx.

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [deshartman](https://github.com/deshartman)
- **Source:** [deshartman/twilio-messaging-mcp-server](https://github.com/deshartman/twilio-messaging-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-deshartman-twilio-messaging-mcp-server
- Seller: https://agentstack.voostack.com/s/deshartman
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.