@twilio-feature-factory/mcp-twilio 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Twilio Agent Factory Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @twilio-feature-factory/mcp-twilio
+
+MCP server exposing 248+ Twilio API operations as tools for Claude agents.
+
+## Install
+
+```bash
+npm install @twilio-feature-factory/mcp-twilio
+```
+
+## Usage
+
+```typescript
+import { createTwilioMcpServer } from '@twilio-feature-factory/mcp-twilio';
+
+const twilioServer = createTwilioMcpServer({
+  accountSid: process.env.TWILIO_ACCOUNT_SID,
+  authToken: process.env.TWILIO_AUTH_TOKEN,
+  defaultFromNumber: process.env.TWILIO_PHONE_NUMBER,
+});
+```
+
+With Claude Agent SDK:
+
+```typescript
+import { query } from '@anthropic-ai/claude-agent-sdk';
+
+for await (const message of query({
+  prompt: "Send an SMS to +15551234567 saying 'Hello from Claude!'",
+  options: {
+    mcpServers: { twilio: twilioServer },
+    allowedTools: ['mcp__twilio__send_sms'],
+  },
+})) {
+  // Agent autonomously sends the SMS
+}
+```
+
+## Tool Coverage
+
+248 tools across 25 modules:
+
+| Priority | Modules | Tools |
+|----------|---------|-------|
+| P0 (Core) | messaging, voice, phone-numbers, verify, sync, taskrouter, debugger | 22 |
+| P1 (High Value) | lookups, studio, messaging-services, serverless | 40 |
+| P2 (Specialized) | intelligence, video, proxy, trusthub, content, voice-config, regulatory, media | 97 |
+| P3 (Edge Cases) | trunking, accounts, iam, pricing, notify, addresses | 61 |
+| Validation | deep-validator, comprehensive-validator | 28 |
+
+## Deep Validation
+
+Goes beyond HTTP 200 to verify actual operation success:
+
+```typescript
+import { DeepValidator } from '@twilio-feature-factory/mcp-twilio';
+import Twilio from 'twilio';
+
+const client = Twilio(accountSid, authToken);
+const validator = new DeepValidator(client);
+
+const result = await validator.validateMessage(messageSid, {
+  waitForTerminal: true,
+  timeout: 30000,
+});
+
+if (!result.success) {
+  console.error('Errors:', result.errors);
+}
+```
+
+Validators: `validateMessage`, `validateCall`, `validateVerification`, `validateTask`, `validateConference`, `validateRecording`, `validateTranscript`, `validateDebugger`, `validateTwoWay`, and more.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `TWILIO_ACCOUNT_SID` | Yes | Account SID |
+| `TWILIO_AUTH_TOKEN` | Yes | Auth Token |
+| `TWILIO_PHONE_NUMBER` | Yes | Default from number (E.164) |
+| `TWILIO_VERIFY_SERVICE_SID` | For verify | Verify Service SID |
+| `TWILIO_SYNC_SERVICE_SID` | For sync | Sync Service SID |
+| `TWILIO_TASKROUTER_WORKSPACE_SID` | For taskrouter | Workspace SID |
+| `TWILIO_MESSAGING_SERVICE_SID` | For messaging services | Messaging Service SID |
+
+## License
+
+MIT