ned"}]}]}]}]}]}] 10:[["$","meta","0",{"charSet":"utf-8"}],["$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}]] b:null 28:I[60719,["7626","static/chunks/f6ab4fea-4425dae3da7674a3.js","8548","static/chunks/b27dc69b-e5acb70cd9d66ddf.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","4902","static/chunks/4902-40271c136eb736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 29:Tcc9,# 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 er

Twilio Messaging MCP Server

Comments