@codespar/mcp-twilio 0.1.0 → 0.2.1

package/README.md

@@ -4,22 +4,32 @@ MCP server for [Twilio](https://www.twilio.com) — the global standard for prog
 
 SMS, WhatsApp, and Voice across 180+ countries. Verify (2FA) and Lookup (phone validation) included. Fills the global messaging gap in a catalog otherwise tilted to Brazil-specific providers (Z-API, Take Blip, Zenvia, Evolution API).
 
-## Tools
+## Tools (22)
 
 | Tool | Purpose |
-|------|---------|
-| `send_message` | Send an SMS or WhatsApp message (prefix `To` with `whatsapp:+E164` for WhatsApp) |
-| `get_message` | Retrieve a message by SID |
-| `list_messages` | List messages with optional filters (To, From, DateSent) |
-| `delete_message` | Delete a message from history |
-| `make_call` | Place an outbound voice call driven by a TwiML `Url` |
-| `get_call` | Retrieve a call by SID |
-| `update_call` | Hang up or redirect an in-progress call |
-| `start_verification` | Send a Verify (2FA) code via sms / whatsapp / call |
-| `check_verification` | Check a Verify (2FA) code |
-| `lookup_phone` | Validate + format + classify a phone number (Lookups v2) |
-| `list_incoming_numbers` | List your Twilio-provisioned phone numbers |
-| `buy_phone_number` | Provision a new phone number |
+|---|---|
+| `send_message` | Send an SMS or WhatsApp message. |
+| `get_message` | Retrieve a message resource by SID (SM... |
+| `list_messages` | List messages with optional filters. |
+| `delete_message` | Delete a message from history. |
+| `make_call` | Place an outbound voice call. |
+| `get_call` | Retrieve a call resource by SID (CA...). |
+| `update_call` | Modify an in-progress call. |
+| `start_verification` | Start a Verify (2FA) challenge. |
+| `check_verification` | Check a Verify (2FA) code against a Service SID. |
+| `lookup_phone` | Validate and normalize a phone number via Lookups v2. |
+| `list_incoming_numbers` | List Twilio-provisioned phone numbers on this account. |
+| `buy_phone_number` | Provision a new phone number. |
+| `list_recordings` | List call recordings on this account. |
+| `create_verify_service` | Create a Verify Service (VA...). |
+| `create_conversation` | Create a Twilio Conversation. |
+| `list_conversations` | List Conversations. |
+| `add_conversation_participant` | Add a participant to a Conversation. |
+| `send_conversation_message` | Post a message into a Conversation. |
+| `list_messaging_services` | List Messaging Services (MG...). |
+| `execute_studio_flow` | Trigger a Studio Flow Execution for a contact. |
+| `create_taskrouter_task` | Create a TaskRouter Task on a Workspace. |
+| `list_taskrouter_workers` | List Workers on a TaskRouter Workspace. |
 
 ## Install
 

package/dist/index.js

@@ -11,28 +11,42 @@
  * providers (Z-API, Take Blip, Zenvia, Evolution API). Twilio ships in 180+
  * countries on day one.
  *
- * Tools (12):
- *   send_message            — send SMS or WhatsApp (prefix `To` with `whatsapp:+E164`)
- *   get_message             — retrieve a message by SID
- *   list_messages           — list messages with optional To/From/DateSent filters
- *   delete_message          — delete a message from history
- *   make_call               — place an outbound voice call driven by a TwiML Url
- *   get_call                — retrieve a call by SID
- *   update_call             — hang up or redirect an in-progress call
- *   start_verification      — send a Verify (2FA) code via sms / whatsapp / call
- *   check_verification      — check a Verify (2FA) code
- *   lookup_phone            — validate + format + classify a phone number
- *   list_incoming_numbers   — list provisioned Twilio phone numbers
- *   buy_phone_number        — provision a new phone number
+ * Tools (22):
+ *   send_message                  — send SMS or WhatsApp (prefix `To` with `whatsapp:+E164`)
+ *   get_message                   — retrieve a message by SID
+ *   list_messages                 — list messages with optional To/From/DateSent filters
+ *   delete_message                — delete a message from history
+ *   make_call                     — place an outbound voice call driven by a TwiML Url
+ *   get_call                      — retrieve a call by SID
+ *   update_call                   — hang up or redirect an in-progress call
+ *   list_recordings               — list call recordings (optionally filtered by CallSid)
+ *   start_verification            — send a Verify (2FA) code via sms / whatsapp / call
+ *   check_verification            — check a Verify (2FA) code
+ *   create_verify_service         — provision a new Verify Service (VA...)
+ *   lookup_phone                  — validate + format + classify a phone number
+ *   list_incoming_numbers         — list provisioned Twilio phone numbers
+ *   buy_phone_number              — provision a new phone number
+ *   create_conversation           — create a Conversation (Conversations API)
+ *   list_conversations            — list Conversations
+ *   add_conversation_participant  — add an SMS / WhatsApp / chat participant to a Conversation
+ *   send_conversation_message     — post a message into a Conversation
+ *   list_messaging_services       — list Messaging Services (MG...)
+ *   execute_studio_flow           — trigger a Studio Flow execution for a contact
+ *   create_taskrouter_task        — create a TaskRouter task on a Workspace
+ *   list_taskrouter_workers       — list TaskRouter Workers on a Workspace
  *
  * Authentication
  *   HTTP Basic with AccountSid:AuthToken.
  *     Authorization: Basic <base64(AccountSid:AuthToken)>
  *
  * API surface
- *   Accounts API : https://api.twilio.com/2010-04-01/Accounts/{AccountSid}
- *   Verify API   : https://verify.twilio.com/v2
- *   Lookups API  : https://lookups.twilio.com/v2
+ *   Accounts API      : https://api.twilio.com/2010-04-01/Accounts/{AccountSid}
+ *   Verify API        : https://verify.twilio.com/v2
+ *   Lookups API       : https://lookups.twilio.com/v2
+ *   Conversations API : https://conversations.twilio.com/v1
+ *   Messaging API     : https://messaging.twilio.com/v1
+ *   Studio API        : https://studio.twilio.com/v2
+ *   TaskRouter API    : https://taskrouter.twilio.com/v1
  *
  *   Request bodies are application/x-www-form-urlencoded. Responses are JSON
  *   (Accounts endpoints use the `.json` suffix).
@@ -96,7 +110,7 @@ function buildQuery(params) {
     const s = q.toString();
     return s ? `?${s}` : "";
 }
-const server = new Server({ name: "mcp-twilio", version: "0.1.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-twilio", version: "0.2.1" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -260,6 +274,144 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "list_recordings",
+            description: "List call recordings on this account. Optionally filter by CallSid, or by DateCreated range. Returns Twilio's paginated list.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    CallSid: { type: "string", description: "Restrict to recordings produced by this Call SID (CA...)" },
+                    DateCreatedAfter: { type: "string", description: "Return recordings created on/after this date (YYYY-MM-DD)" },
+                    DateCreatedBefore: { type: "string", description: "Return recordings created on/before this date (YYYY-MM-DD)" },
+                    PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+                },
+            },
+        },
+        {
+            name: "create_verify_service",
+            description: "Create a Verify Service (VA...). A service groups verification attempts and holds per-service config (code length, friendly name).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    FriendlyName: { type: "string", description: "Human-readable name for the service (e.g. your app name)" },
+                    CodeLength: { type: "number", description: "OTP code length, 4-10 (default 6)" },
+                    LookupEnabled: { type: "boolean", description: "Run Lookup on targets before sending (blocks invalid numbers)" },
+                    DefaultTemplateSid: { type: "string", description: "Default message template SID" },
+                },
+                required: ["FriendlyName"],
+            },
+        },
+        {
+            name: "create_conversation",
+            description: "Create a Twilio Conversation. Conversations host multi-channel (SMS / WhatsApp / chat) threads with server-side history.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    FriendlyName: { type: "string", description: "Human-readable label for the conversation" },
+                    UniqueName: { type: "string", description: "Developer-defined unique identifier (alternative addressable key)" },
+                    MessagingServiceSid: { type: "string", description: "Messaging Service SID (MG...) used for outbound SMS/WhatsApp in this conversation" },
+                    Attributes: { type: "string", description: "JSON string of custom attributes stored on the conversation" },
+                },
+            },
+        },
+        {
+            name: "list_conversations",
+            description: "List Conversations. Returns a paginated list; pass PageSize to cap.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    StartDate: { type: "string", description: "Only include conversations created on/after this ISO-8601 date" },
+                    EndDate: { type: "string", description: "Only include conversations created on/before this ISO-8601 date" },
+                    State: { type: "string", enum: ["active", "inactive", "closed"], description: "Filter by conversation state" },
+                    PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+                },
+            },
+        },
+        {
+            name: "add_conversation_participant",
+            description: "Add a participant to a Conversation. For SMS / WhatsApp, pass MessagingBinding.Address (+E164 or whatsapp:+E164) + MessagingBinding.ProxyAddress (your Twilio number). For chat participants, pass Identity.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ConversationSid: { type: "string", description: "Conversation SID (CH...) or UniqueName" },
+                    Identity: { type: "string", description: "Chat identity (use for in-app chat participants)" },
+                    "MessagingBinding.Address": { type: "string", description: "Participant's address: +E164 for SMS, whatsapp:+E164 for WhatsApp" },
+                    "MessagingBinding.ProxyAddress": { type: "string", description: "Your Twilio number the participant messages with (E.164 or whatsapp:+E164)" },
+                    Attributes: { type: "string", description: "JSON string of custom participant attributes" },
+                },
+                required: ["ConversationSid"],
+            },
+        },
+        {
+            name: "send_conversation_message",
+            description: "Post a message into a Conversation. Fanned out to all participants via their channel (SMS / WhatsApp / chat).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    ConversationSid: { type: "string", description: "Conversation SID (CH...) or UniqueName" },
+                    Body: { type: "string", description: "Message text (UTF-8)" },
+                    Author: { type: "string", description: "Identity of the author (defaults to `system` if omitted)" },
+                    MediaSid: { type: "string", description: "Media SID (ME...) from a prior MCS upload" },
+                    Attributes: { type: "string", description: "JSON string of custom message attributes" },
+                },
+                required: ["ConversationSid"],
+            },
+        },
+        {
+            name: "list_messaging_services",
+            description: "List Messaging Services (MG...). A Messaging Service bundles sender pools, templates, and routing rules.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+                },
+            },
+        },
+        {
+            name: "execute_studio_flow",
+            description: "Trigger a Studio Flow Execution for a contact. Studio flows are visual IVR / workflow builders — this kicks one off for a specific To/From pair.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    FlowSid: { type: "string", description: "Studio Flow SID (FW...)" },
+                    To: { type: "string", description: "Contact address (E.164 or whatsapp:+E164)" },
+                    From: { type: "string", description: "Your Twilio number (E.164 or whatsapp:+E164)" },
+                    Parameters: { type: "string", description: "JSON string of variables injected into the flow's execution context" },
+                },
+                required: ["FlowSid", "To", "From"],
+            },
+        },
+        {
+            name: "create_taskrouter_task",
+            description: "Create a TaskRouter Task on a Workspace. TaskRouter routes work (calls, chats, tickets) to eligible Workers based on attributes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    WorkspaceSid: { type: "string", description: "TaskRouter Workspace SID (WS...)" },
+                    Attributes: { type: "string", description: "JSON string of task attributes used for routing (e.g. {\"selected_language\":\"pt-br\"})" },
+                    WorkflowSid: { type: "string", description: "Workflow SID (WW...) that decides how this task is routed" },
+                    TaskChannel: { type: "string", description: "Task channel unique_name or SID (e.g. voice, chat, sms, default)" },
+                    Priority: { type: "number", description: "Priority (higher = more urgent)" },
+                    Timeout: { type: "number", description: "Seconds before the task times out (default 86400)" },
+                },
+                required: ["WorkspaceSid"],
+            },
+        },
+        {
+            name: "list_taskrouter_workers",
+            description: "List Workers on a TaskRouter Workspace. Optionally filter by ActivityName, Available, or TargetWorkersExpression.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    WorkspaceSid: { type: "string", description: "TaskRouter Workspace SID (WS...)" },
+                    ActivityName: { type: "string", description: "Filter by activity name (e.g. Available, Idle, Offline)" },
+                    Available: { type: "string", description: "Filter by availability: 'true' or 'false'" },
+                    TargetWorkersExpression: { type: "string", description: "TaskRouter expression to filter workers (e.g. languages HAS \"pt-br\")" },
+                    PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+                },
+                required: ["WorkspaceSid"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -370,6 +522,106 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     body.StatusCallback = a.StatusCallback;
                 return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "/IncomingPhoneNumbers.json", body), null, 2) }] };
             }
+            case "list_recordings": {
+                const q = buildQuery({
+                    CallSid: a.CallSid,
+                    "DateCreated>": a.DateCreatedAfter,
+                    "DateCreated<": a.DateCreatedBefore,
+                    PageSize: a.PageSize,
+                });
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `/Recordings.json${q}`), null, 2) }] };
+            }
+            case "create_verify_service": {
+                const body = { FriendlyName: a.FriendlyName };
+                if (a.CodeLength !== undefined)
+                    body.CodeLength = a.CodeLength;
+                if (a.LookupEnabled !== undefined)
+                    body.LookupEnabled = a.LookupEnabled;
+                if (a.DefaultTemplateSid)
+                    body.DefaultTemplateSid = a.DefaultTemplateSid;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "https://verify.twilio.com/v2/Services", body), null, 2) }] };
+            }
+            case "create_conversation": {
+                const body = {};
+                if (a.FriendlyName)
+                    body.FriendlyName = a.FriendlyName;
+                if (a.UniqueName)
+                    body.UniqueName = a.UniqueName;
+                if (a.MessagingServiceSid)
+                    body.MessagingServiceSid = a.MessagingServiceSid;
+                if (a.Attributes)
+                    body.Attributes = a.Attributes;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "https://conversations.twilio.com/v1/Conversations", body), null, 2) }] };
+            }
+            case "list_conversations": {
+                const q = buildQuery({
+                    StartDate: a.StartDate,
+                    EndDate: a.EndDate,
+                    State: a.State,
+                    PageSize: a.PageSize,
+                });
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://conversations.twilio.com/v1/Conversations${q}`), null, 2) }] };
+            }
+            case "add_conversation_participant": {
+                const body = {};
+                if (a.Identity)
+                    body.Identity = a.Identity;
+                if (a["MessagingBinding.Address"])
+                    body["MessagingBinding.Address"] = a["MessagingBinding.Address"];
+                if (a["MessagingBinding.ProxyAddress"])
+                    body["MessagingBinding.ProxyAddress"] = a["MessagingBinding.ProxyAddress"];
+                if (a.Attributes)
+                    body.Attributes = a.Attributes;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://conversations.twilio.com/v1/Conversations/${a.ConversationSid}/Participants`, body), null, 2) }] };
+            }
+            case "send_conversation_message": {
+                const body = {};
+                if (a.Body)
+                    body.Body = a.Body;
+                if (a.Author)
+                    body.Author = a.Author;
+                if (a.MediaSid)
+                    body.MediaSid = a.MediaSid;
+                if (a.Attributes)
+                    body.Attributes = a.Attributes;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://conversations.twilio.com/v1/Conversations/${a.ConversationSid}/Messages`, body), null, 2) }] };
+            }
+            case "list_messaging_services": {
+                const q = buildQuery({ PageSize: a.PageSize });
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://messaging.twilio.com/v1/Services${q}`), null, 2) }] };
+            }
+            case "execute_studio_flow": {
+                const body = {
+                    To: a.To,
+                    From: a.From,
+                };
+                if (a.Parameters)
+                    body.Parameters = a.Parameters;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://studio.twilio.com/v2/Flows/${a.FlowSid}/Executions`, body), null, 2) }] };
+            }
+            case "create_taskrouter_task": {
+                const body = {};
+                if (a.Attributes)
+                    body.Attributes = a.Attributes;
+                if (a.WorkflowSid)
+                    body.WorkflowSid = a.WorkflowSid;
+                if (a.TaskChannel)
+                    body.TaskChannel = a.TaskChannel;
+                if (a.Priority !== undefined)
+                    body.Priority = a.Priority;
+                if (a.Timeout !== undefined)
+                    body.Timeout = a.Timeout;
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://taskrouter.twilio.com/v1/Workspaces/${a.WorkspaceSid}/Tasks`, body), null, 2) }] };
+            }
+            case "list_taskrouter_workers": {
+                const q = buildQuery({
+                    ActivityName: a.ActivityName,
+                    Available: a.Available,
+                    TargetWorkersExpression: a.TargetWorkersExpression,
+                    PageSize: a.PageSize,
+                });
+                return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://taskrouter.twilio.com/v1/Workspaces/${a.WorkspaceSid}/Workers${q}`), null, 2) }] };
+            }
             default:
                 return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
         }
@@ -396,7 +648,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-twilio", version: "0.1.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-twilio", version: "0.2.1" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codespar/mcp-twilio",
-  "version": "0.1.0",
-  "description": "MCP server for Twilio — global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries",
+  "version": "0.2.1",
+  "description": "MCP server for Twilio \u2014 global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {

package/server.json

@@ -7,12 +7,12 @@
     "source": "github",
     "subfolder": "packages/communication/twilio"
   },
-  "version": "0.1.0",
+  "version": "0.2.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-twilio",
-      "version": "0.1.0",
+      "version": "0.2.1",
       "transport": {
         "type": "stdio"
       },

package/src/index.ts

@@ -12,28 +12,42 @@
  * providers (Z-API, Take Blip, Zenvia, Evolution API). Twilio ships in 180+
  * countries on day one.
  *
- * Tools (12):
- *   send_message            — send SMS or WhatsApp (prefix `To` with `whatsapp:+E164`)
- *   get_message             — retrieve a message by SID
- *   list_messages           — list messages with optional To/From/DateSent filters
- *   delete_message          — delete a message from history
- *   make_call               — place an outbound voice call driven by a TwiML Url
- *   get_call                — retrieve a call by SID
- *   update_call             — hang up or redirect an in-progress call
- *   start_verification      — send a Verify (2FA) code via sms / whatsapp / call
- *   check_verification      — check a Verify (2FA) code
- *   lookup_phone            — validate + format + classify a phone number
- *   list_incoming_numbers   — list provisioned Twilio phone numbers
- *   buy_phone_number        — provision a new phone number
+ * Tools (22):
+ *   send_message                  — send SMS or WhatsApp (prefix `To` with `whatsapp:+E164`)
+ *   get_message                   — retrieve a message by SID
+ *   list_messages                 — list messages with optional To/From/DateSent filters
+ *   delete_message                — delete a message from history
+ *   make_call                     — place an outbound voice call driven by a TwiML Url
+ *   get_call                      — retrieve a call by SID
+ *   update_call                   — hang up or redirect an in-progress call
+ *   list_recordings               — list call recordings (optionally filtered by CallSid)
+ *   start_verification            — send a Verify (2FA) code via sms / whatsapp / call
+ *   check_verification            — check a Verify (2FA) code
+ *   create_verify_service         — provision a new Verify Service (VA...)
+ *   lookup_phone                  — validate + format + classify a phone number
+ *   list_incoming_numbers         — list provisioned Twilio phone numbers
+ *   buy_phone_number              — provision a new phone number
+ *   create_conversation           — create a Conversation (Conversations API)
+ *   list_conversations            — list Conversations
+ *   add_conversation_participant  — add an SMS / WhatsApp / chat participant to a Conversation
+ *   send_conversation_message     — post a message into a Conversation
+ *   list_messaging_services       — list Messaging Services (MG...)
+ *   execute_studio_flow           — trigger a Studio Flow execution for a contact
+ *   create_taskrouter_task        — create a TaskRouter task on a Workspace
+ *   list_taskrouter_workers       — list TaskRouter Workers on a Workspace
  *
  * Authentication
  *   HTTP Basic with AccountSid:AuthToken.
  *     Authorization: Basic <base64(AccountSid:AuthToken)>
  *
  * API surface
- *   Accounts API : https://api.twilio.com/2010-04-01/Accounts/{AccountSid}
- *   Verify API   : https://verify.twilio.com/v2
- *   Lookups API  : https://lookups.twilio.com/v2
+ *   Accounts API      : https://api.twilio.com/2010-04-01/Accounts/{AccountSid}
+ *   Verify API        : https://verify.twilio.com/v2
+ *   Lookups API       : https://lookups.twilio.com/v2
+ *   Conversations API : https://conversations.twilio.com/v1
+ *   Messaging API     : https://messaging.twilio.com/v1
+ *   Studio API        : https://studio.twilio.com/v2
+ *   TaskRouter API    : https://taskrouter.twilio.com/v1
  *
  *   Request bodies are application/x-www-form-urlencoded. Responses are JSON
  *   (Accounts endpoints use the `.json` suffix).
@@ -109,7 +123,7 @@ function buildQuery(params: Record<string, unknown>): string {
 }
 
 const server = new Server(
-  { name: "mcp-twilio", version: "0.1.0" },
+  { name: "mcp-twilio", version: "0.2.1" },
   { capabilities: { tools: {} } }
 );
 
@@ -276,6 +290,144 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
       },
     },
+    {
+      name: "list_recordings",
+      description: "List call recordings on this account. Optionally filter by CallSid, or by DateCreated range. Returns Twilio's paginated list.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          CallSid: { type: "string", description: "Restrict to recordings produced by this Call SID (CA...)" },
+          DateCreatedAfter: { type: "string", description: "Return recordings created on/after this date (YYYY-MM-DD)" },
+          DateCreatedBefore: { type: "string", description: "Return recordings created on/before this date (YYYY-MM-DD)" },
+          PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+        },
+      },
+    },
+    {
+      name: "create_verify_service",
+      description: "Create a Verify Service (VA...). A service groups verification attempts and holds per-service config (code length, friendly name).",
+      inputSchema: {
+        type: "object",
+        properties: {
+          FriendlyName: { type: "string", description: "Human-readable name for the service (e.g. your app name)" },
+          CodeLength: { type: "number", description: "OTP code length, 4-10 (default 6)" },
+          LookupEnabled: { type: "boolean", description: "Run Lookup on targets before sending (blocks invalid numbers)" },
+          DefaultTemplateSid: { type: "string", description: "Default message template SID" },
+        },
+        required: ["FriendlyName"],
+      },
+    },
+    {
+      name: "create_conversation",
+      description: "Create a Twilio Conversation. Conversations host multi-channel (SMS / WhatsApp / chat) threads with server-side history.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          FriendlyName: { type: "string", description: "Human-readable label for the conversation" },
+          UniqueName: { type: "string", description: "Developer-defined unique identifier (alternative addressable key)" },
+          MessagingServiceSid: { type: "string", description: "Messaging Service SID (MG...) used for outbound SMS/WhatsApp in this conversation" },
+          Attributes: { type: "string", description: "JSON string of custom attributes stored on the conversation" },
+        },
+      },
+    },
+    {
+      name: "list_conversations",
+      description: "List Conversations. Returns a paginated list; pass PageSize to cap.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          StartDate: { type: "string", description: "Only include conversations created on/after this ISO-8601 date" },
+          EndDate: { type: "string", description: "Only include conversations created on/before this ISO-8601 date" },
+          State: { type: "string", enum: ["active", "inactive", "closed"], description: "Filter by conversation state" },
+          PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+        },
+      },
+    },
+    {
+      name: "add_conversation_participant",
+      description: "Add a participant to a Conversation. For SMS / WhatsApp, pass MessagingBinding.Address (+E164 or whatsapp:+E164) + MessagingBinding.ProxyAddress (your Twilio number). For chat participants, pass Identity.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ConversationSid: { type: "string", description: "Conversation SID (CH...) or UniqueName" },
+          Identity: { type: "string", description: "Chat identity (use for in-app chat participants)" },
+          "MessagingBinding.Address": { type: "string", description: "Participant's address: +E164 for SMS, whatsapp:+E164 for WhatsApp" },
+          "MessagingBinding.ProxyAddress": { type: "string", description: "Your Twilio number the participant messages with (E.164 or whatsapp:+E164)" },
+          Attributes: { type: "string", description: "JSON string of custom participant attributes" },
+        },
+        required: ["ConversationSid"],
+      },
+    },
+    {
+      name: "send_conversation_message",
+      description: "Post a message into a Conversation. Fanned out to all participants via their channel (SMS / WhatsApp / chat).",
+      inputSchema: {
+        type: "object",
+        properties: {
+          ConversationSid: { type: "string", description: "Conversation SID (CH...) or UniqueName" },
+          Body: { type: "string", description: "Message text (UTF-8)" },
+          Author: { type: "string", description: "Identity of the author (defaults to `system` if omitted)" },
+          MediaSid: { type: "string", description: "Media SID (ME...) from a prior MCS upload" },
+          Attributes: { type: "string", description: "JSON string of custom message attributes" },
+        },
+        required: ["ConversationSid"],
+      },
+    },
+    {
+      name: "list_messaging_services",
+      description: "List Messaging Services (MG...). A Messaging Service bundles sender pools, templates, and routing rules.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+        },
+      },
+    },
+    {
+      name: "execute_studio_flow",
+      description: "Trigger a Studio Flow Execution for a contact. Studio flows are visual IVR / workflow builders — this kicks one off for a specific To/From pair.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          FlowSid: { type: "string", description: "Studio Flow SID (FW...)" },
+          To: { type: "string", description: "Contact address (E.164 or whatsapp:+E164)" },
+          From: { type: "string", description: "Your Twilio number (E.164 or whatsapp:+E164)" },
+          Parameters: { type: "string", description: "JSON string of variables injected into the flow's execution context" },
+        },
+        required: ["FlowSid", "To", "From"],
+      },
+    },
+    {
+      name: "create_taskrouter_task",
+      description: "Create a TaskRouter Task on a Workspace. TaskRouter routes work (calls, chats, tickets) to eligible Workers based on attributes.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          WorkspaceSid: { type: "string", description: "TaskRouter Workspace SID (WS...)" },
+          Attributes: { type: "string", description: "JSON string of task attributes used for routing (e.g. {\"selected_language\":\"pt-br\"})" },
+          WorkflowSid: { type: "string", description: "Workflow SID (WW...) that decides how this task is routed" },
+          TaskChannel: { type: "string", description: "Task channel unique_name or SID (e.g. voice, chat, sms, default)" },
+          Priority: { type: "number", description: "Priority (higher = more urgent)" },
+          Timeout: { type: "number", description: "Seconds before the task times out (default 86400)" },
+        },
+        required: ["WorkspaceSid"],
+      },
+    },
+    {
+      name: "list_taskrouter_workers",
+      description: "List Workers on a TaskRouter Workspace. Optionally filter by ActivityName, Available, or TargetWorkersExpression.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          WorkspaceSid: { type: "string", description: "TaskRouter Workspace SID (WS...)" },
+          ActivityName: { type: "string", description: "Filter by activity name (e.g. Available, Idle, Offline)" },
+          Available: { type: "string", description: "Filter by availability: 'true' or 'false'" },
+          TargetWorkersExpression: { type: "string", description: "TaskRouter expression to filter workers (e.g. languages HAS \"pt-br\")" },
+          PageSize: { type: "number", description: "Max rows per page (default 50, max 1000)" },
+        },
+        required: ["WorkspaceSid"],
+      },
+    },
   ],
 }));
 
@@ -370,6 +522,85 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (a.StatusCallback) body.StatusCallback = a.StatusCallback;
         return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "/IncomingPhoneNumbers.json", body), null, 2) }] };
       }
+      case "list_recordings": {
+        const q = buildQuery({
+          CallSid: a.CallSid,
+          "DateCreated>": a.DateCreatedAfter,
+          "DateCreated<": a.DateCreatedBefore,
+          PageSize: a.PageSize,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `/Recordings.json${q}`), null, 2) }] };
+      }
+      case "create_verify_service": {
+        const body: Record<string, unknown> = { FriendlyName: a.FriendlyName };
+        if (a.CodeLength !== undefined) body.CodeLength = a.CodeLength;
+        if (a.LookupEnabled !== undefined) body.LookupEnabled = a.LookupEnabled;
+        if (a.DefaultTemplateSid) body.DefaultTemplateSid = a.DefaultTemplateSid;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "https://verify.twilio.com/v2/Services", body), null, 2) }] };
+      }
+      case "create_conversation": {
+        const body: Record<string, unknown> = {};
+        if (a.FriendlyName) body.FriendlyName = a.FriendlyName;
+        if (a.UniqueName) body.UniqueName = a.UniqueName;
+        if (a.MessagingServiceSid) body.MessagingServiceSid = a.MessagingServiceSid;
+        if (a.Attributes) body.Attributes = a.Attributes;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", "https://conversations.twilio.com/v1/Conversations", body), null, 2) }] };
+      }
+      case "list_conversations": {
+        const q = buildQuery({
+          StartDate: a.StartDate,
+          EndDate: a.EndDate,
+          State: a.State,
+          PageSize: a.PageSize,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://conversations.twilio.com/v1/Conversations${q}`), null, 2) }] };
+      }
+      case "add_conversation_participant": {
+        const body: Record<string, unknown> = {};
+        if (a.Identity) body.Identity = a.Identity;
+        if (a["MessagingBinding.Address"]) body["MessagingBinding.Address"] = a["MessagingBinding.Address"];
+        if (a["MessagingBinding.ProxyAddress"]) body["MessagingBinding.ProxyAddress"] = a["MessagingBinding.ProxyAddress"];
+        if (a.Attributes) body.Attributes = a.Attributes;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://conversations.twilio.com/v1/Conversations/${a.ConversationSid}/Participants`, body), null, 2) }] };
+      }
+      case "send_conversation_message": {
+        const body: Record<string, unknown> = {};
+        if (a.Body) body.Body = a.Body;
+        if (a.Author) body.Author = a.Author;
+        if (a.MediaSid) body.MediaSid = a.MediaSid;
+        if (a.Attributes) body.Attributes = a.Attributes;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://conversations.twilio.com/v1/Conversations/${a.ConversationSid}/Messages`, body), null, 2) }] };
+      }
+      case "list_messaging_services": {
+        const q = buildQuery({ PageSize: a.PageSize });
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://messaging.twilio.com/v1/Services${q}`), null, 2) }] };
+      }
+      case "execute_studio_flow": {
+        const body: Record<string, unknown> = {
+          To: a.To,
+          From: a.From,
+        };
+        if (a.Parameters) body.Parameters = a.Parameters;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://studio.twilio.com/v2/Flows/${a.FlowSid}/Executions`, body), null, 2) }] };
+      }
+      case "create_taskrouter_task": {
+        const body: Record<string, unknown> = {};
+        if (a.Attributes) body.Attributes = a.Attributes;
+        if (a.WorkflowSid) body.WorkflowSid = a.WorkflowSid;
+        if (a.TaskChannel) body.TaskChannel = a.TaskChannel;
+        if (a.Priority !== undefined) body.Priority = a.Priority;
+        if (a.Timeout !== undefined) body.Timeout = a.Timeout;
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("POST", `https://taskrouter.twilio.com/v1/Workspaces/${a.WorkspaceSid}/Tasks`, body), null, 2) }] };
+      }
+      case "list_taskrouter_workers": {
+        const q = buildQuery({
+          ActivityName: a.ActivityName,
+          Available: a.Available,
+          TargetWorkersExpression: a.TargetWorkersExpression,
+          PageSize: a.PageSize,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(await twilioRequest("GET", `https://taskrouter.twilio.com/v1/Workspaces/${a.WorkspaceSid}/Workers${q}`), null, 2) }] };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }
@@ -392,7 +623,7 @@ async function main() {
       if (!sid && isInitializeRequest(req.body)) {
         const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
         t.onclose = () => { if (t.sessionId) transports.delete(t.sessionId); };
-        const s = new Server({ name: "mcp-twilio", version: "0.1.0" }, { capabilities: { tools: {} } });
+        const s = new Server({ name: "mcp-twilio", version: "0.2.1" }, { capabilities: { tools: {} } });
         (server as unknown as { _requestHandlers: Map<unknown, unknown> })._requestHandlers.forEach((v, k) => (s as unknown as { _requestHandlers: Map<unknown, unknown> })._requestHandlers.set(k, v));
         (server as unknown as { _notificationHandlers?: Map<unknown, unknown> })._notificationHandlers?.forEach((v, k) => (s as unknown as { _notificationHandlers: Map<unknown, unknown> })._notificationHandlers.set(k, v));
         await s.connect(t);