@codespar/mcp-zenvia 0.2.0 → 0.2.2

package/README.md

@@ -49,18 +49,28 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
+## Tools (18)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `send_sms` | Send an SMS message |
 | `send_whatsapp` | Send a WhatsApp message |
 | `send_rcs` | Send an RCS (Rich Communication Services) message |
+| `send_email` | Send a transactional email |
+| `send_voice` | Send a voice message via TTS or pre-recorded audio URL |
+| `send_facebook_message` | Send a Facebook Messenger message |
 | `get_message_status` | Get message delivery status by ID |
 | `list_channels` | List available messaging channels |
 | `create_subscription` | Create a webhook subscription for message events |
+| `list_subscriptions` | List all webhook subscriptions |
+| `delete_subscription` | Delete a webhook subscription by ID |
 | `list_contacts` | List contacts from the contact base |
+| `create_contact` | Create a contact in the contact base |
+| `delete_contact` | Delete a contact by ID |
 | `send_template` | Send a WhatsApp template message (pre-approved) |
+| `list_templates` | List approved message templates (WhatsApp/SMS/RCS) |
+| `get_report_entries` | Get message report entries within a date range |
+| `add_opt_out` | Add a phone number to the opt-out list (suppresses future messages) |
 
 ## Authentication
 
@@ -96,13 +106,13 @@ Zenvia provides a sandbox via the dashboard for testing messages.
 - `chatbot_integration` — Integrate with Zenvia chatbot builder
 - `analytics_dashboard` — Get channel analytics and metrics
 
-Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-brasil) or [request a tool](https://github.com/codespar/mcp-dev-brasil/issues).
+Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).
 
 ## Links
 
 - [Zenvia Website](https://zenvia.com)
 - [Zenvia API Documentation](https://zenvia.github.io/zenvia-openapi-spec)
-- [MCP Dev Brasil](https://github.com/codespar/mcp-dev-brasil)
+- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)
 - [Landing Page](https://codespar.dev/mcp)
 
 ## Enterprise

package/dist/index.js

@@ -49,7 +49,10 @@ async function zenviaRequest(method, path, body) {
     const text = await res.text();
     return text ? JSON.parse(text) : { ok: true };
 }
-const server = new Server({ name: "mcp-zenvia", 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-zenvia", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -371,7 +374,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-zenvia", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-zenvia", 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-zenvia",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Zenvia — SMS, WhatsApp, RCS, Email, Voice, Facebook messaging, templates and reports",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -3,16 +3,16 @@
   "name": "io.github.codespar/mcp-zenvia",
   "description": "MCP server for Zenvia — SMS, WhatsApp, RCS, Email, Voice, Facebook messaging, templates and reports",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/communication/zenvia"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-zenvia",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -26,5 +26,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.zenvia.com",
+    "logoUrl": "https://logo.clearbit.com/zenvia.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=zenvia.com&sz=128",
+    "docsUrl": "https://zenvia.github.io",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/__tests__/index.test.ts

@@ -32,9 +32,9 @@ beforeEach(async () => {
 });
 
 describe("mcp-zenvia", () => {
-  it("should register 8 tools", async () => {
+  it("should register 18 tools", async () => {
     const result = await listToolsHandler();
-    expect(result.tools).toHaveLength(8);
+    expect(result.tools).toHaveLength(18);
   });
 
   it("should call correct API endpoint for send_sms", async () => {

package/src/index.ts

@@ -57,9 +57,14 @@ async function zenviaRequest(method: string, path: string, body?: unknown): Prom
   return text ? JSON.parse(text) : { ok: true };
 }
 
+// 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-zenvia", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-zenvia", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -370,7 +375,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-zenvia", version: "0.2.0" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
+        const s = new Server({ name: "mcp-zenvia", version: "0.2.1" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
         await t.handleRequest(req, res, req.body); return;
       }
       res.status(400).json({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request" }, id: null });