Twilio Monitor MCP Server

English | 日本語

An MCP (Model Context Protocol) server that wraps the Twilio Monitor API, allowing you to retrieve Twilio alerts and events directly from Claude Code and other MCP clients.

Quick Start

Get started instantly with npx (no installation required):

npx @geekfeed/mcp-twilio-monitor

Features

• ✅ List and retrieve Twilio Monitor alerts
• ✅ List and retrieve Twilio Monitor events
• ✅ Filter by date range, log level, and other criteria
• ✅ Works with Claude Code and other MCP clients
• ✅ Zero installation with npx

Setup

Getting Your Twilio Credentials

Before setting up, get your credentials from Twilio Console:

1. Find your Account SID and Auth Token on the dashboard
2. Use these values in the configuration below

Configuration (Works with all MCP clients)

This server works with any MCP-compatible client including Claude Code, Claude Desktop, Cline, Continue, and others.

Example configuration for Claude Code (.mcp.json):

{
  "mcpServers": {
    "twilio-monitor": {
      "command": "npx",
      "args": ["@geekfeed/mcp-twilio-monitor"],
      "env": {
        "TWILIO_ACCOUNT_SID": "your_account_sid",
        "TWILIO_AUTH_TOKEN": "your_auth_token"
      }
    }
  }
}

For other MCP clients, use the same configuration structure. Common config file locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
• Cline: VS Code Settings → "Cline: MCP Settings"
• Continue: Continue Settings → experimental.modelContextProtocolServers

Alternative Installation Methods

If you prefer to install the package instead of using npx:

# Local installation
npm install @geekfeed/mcp-twilio-monitor

# Global installation
npm install -g @geekfeed/mcp-twilio-monitor

Then use node /path/to/node_modules/@geekfeed/mcp-twilio-monitor/dist/index.js or just mcp-twilio-monitor (if globally installed) as the command.

Available Tools

1. list_alerts

List alerts generated by Twilio when issues are detected with your account.

Parameters:

• limit (number, optional): Maximum number of alerts to return (default: 20, max: 1000)
• logLevel (string, optional): Filter by log level: error, warning, notice, or debug
• startDate (string, optional): Filter alerts created on or after this date (ISO 8601: YYYY-MM-DD)
• endDate (string, optional): Filter alerts created on or before this date (ISO 8601: YYYY-MM-DD)

2. get_alert

Get details of a specific alert by its SID.

Parameters:

• alertSid (string, required): The SID of the alert to retrieve

3. list_events

List events representing important occurrences in your Twilio account.

Parameters:

• limit (number, optional): Maximum number of events to return (default: 20, max: 1000)
• actorSid (string, optional): Filter by the SID of the actor that caused the event
• eventType (string, optional): Filter by event type (e.g., 'account.updated', 'call.created')
• resourceSid (string, optional): Filter by the SID of the affected resource
• sourceIpAddress (string, optional): Filter by source IP address
• startDate (string, optional): Filter events created on or after this date (ISO 8601: YYYY-MM-DD)
• endDate (string, optional): Filter events created on or before this date (ISO 8601: YYYY-MM-DD)

4. get_event

Get details of a specific event by its SID.

Parameters:

• eventSid (string, required): The SID of the event to retrieve

Usage Examples

Once configured in Claude Code, you can use natural language to interact with your Twilio Monitor data:

Show me the latest error alerts from the last 10 calls

Get all events that occurred today

Show details for alert NO12345678901234567890123456789012

Troubleshooting

Authentication Errors

• Verify that TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN are correctly set
• Check your credentials in the Twilio Console
• Ensure there are no extra spaces or quotes in your credentials

Connection Errors

• Check your network connection
• Verify Twilio API status at status.twilio.com
• Ensure your firewall allows outbound connections to Twilio's API

Requirements

• Node.js 14 or higher
• Twilio account with Monitor API access

Author

Shinji Uchi / GeekFeed Co.,Ltd.

• Website: https://www.geekfeed.co.jp

License

MIT