@codespar/mcp-twilio 0.2.0 → 0.2.2

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
 
@@ -71,6 +81,10 @@ npx @codespar/mcp-twilio
 MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-twilio
 ```
 
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
 ## License
 
 MIT

package/dist/index.js

@@ -110,7 +110,10 @@ function buildQuery(params) {
     const s = q.toString();
     return s ? `?${s}` : "";
 }
-const server = new Server({ name: "mcp-twilio", version: "0.2.0" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-twilio", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -648,7 +651,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.2.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,6 +1,6 @@
 {
   "name": "@codespar/mcp-twilio",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Twilio — global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -3,16 +3,16 @@
   "name": "io.github.codespar/mcp-twilio",
   "description": "MCP server for Twilio — global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/communication/twilio"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-twilio",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -40,5 +40,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.twilio.com",
+    "logoUrl": "https://logo.clearbit.com/twilio.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=twilio.com&sz=128",
+    "docsUrl": "https://www.twilio.com/docs",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -122,9 +122,14 @@ function buildQuery(params: Record<string, unknown>): string {
   return s ? `?${s}` : "";
 }
 
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT =
+  "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+
 const server = new Server(
-  { name: "mcp-twilio", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-twilio", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -623,7 +628,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.2.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);