@codespar/mcp-whatsapp-cloud 0.2.0 → 0.2.2

package/README.md

@@ -14,21 +14,32 @@ MCP server for the [WhatsApp Cloud API](https://developers.facebook.com/docs/wha
 | take-blip | Brazilian BSP wrapper | Enterprise Brazil, CCaaS features |
 | zenvia | Brazilian BSP wrapper | Brazil omnichannel (SMS + WhatsApp) |
 
-## Tools
+## Tools (22)
 
 | Tool | Purpose |
-|------|---------|
-| `send_text_message` | Send a plain text message |
-| `send_template_message` | Send an approved template (required for business-initiated > 24h) |
-| `send_media_message` | Send image, video, document, or audio (link or media_id) |
-| `send_interactive_message` | Send reply buttons or list |
-| `send_location_message` | Send a latitude/longitude pin |
-| `mark_message_as_read` | Mark an inbound message as read |
-| `upload_media` | Upload a file and get a reusable media_id (multipart) |
-| `retrieve_media_url` | Resolve a media_id to a downloadable URL |
-| `delete_media` | Delete an uploaded media asset |
-| `list_templates` | List templates on the WABA |
-| `create_template` | Submit a new template for Meta review |
+|---|---|
+| `send_text_message` | Send a plain text message. |
+| `send_template_message` | Send an approved message template. |
+| `send_media_message` | Send an image, video, document, or audio. |
+| `send_interactive_message` | Send an interactive message (reply buttons or list). |
+| `send_interactive_cta_url` | Send an interactive message with a single CTA URL button. |
+| `send_interactive_flow` | Send a WhatsApp Flow message. |
+| `send_location_message` | Send a location pin with latitude/longitude and optional name/address. |
+| `send_contacts_message` | Send one or more contact cards (vCard-like). |
+| `send_reaction_message` | Send an emoji reaction on a previously received/sent message. |
+| `send_typing_indicator` | Show a typing indicator on a received message. |
+| `mark_message_as_read` | Mark an incoming message as read so the sender sees the blue double-check. |
+| `upload_media` | Upload a media file and get back a media_id reusable in send_media_message. |
+| `retrieve_media_url` | Resolve a media_id to a short-lived downloadable URL. |
+| `delete_media` | Delete an uploaded media asset by id. |
+| `list_templates` | List message templates on the WhatsApp Business Account. |
+| `create_template` | Submit a new template for Meta review. |
+| `delete_template` | Delete a message template from the WABA by name. |
+| `get_business_profile` | Read the WhatsApp business profile (about, description, email, websites, vertical, address) for the configu... |
+| `update_business_profile` | Update the business profile on the configured phone number. |
+| `list_phone_numbers` | List all phone numbers registered under the WhatsApp Business Account, including display name, quality rati... |
+| `request_verification_code` | Request Meta to send a verification code to the configured phone number via SMS or voice. |
+| `verify_code` | Submit the verification code received via SMS/voice after request_verification_code. |
 
 ## Install
 
@@ -98,6 +109,10 @@ npx @codespar/mcp-whatsapp-cloud
 MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-whatsapp-cloud
 ```
 
+## 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

@@ -97,7 +97,10 @@ async function whatsappRequest(method, path, body, opts = {}) {
     const text = await res.text();
     return text ? JSON.parse(text) : {};
 }
-const server = new Server({ name: "mcp-whatsapp-cloud", 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-whatsapp-cloud", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -686,7 +689,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-whatsapp-cloud", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-whatsapp-cloud", 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-whatsapp-cloud",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for WhatsApp Cloud API (Meta direct) — official Graph API integration for messages, media, and templates",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.codespar/mcp-whatsapp-cloud",
-  "description": "MCP server for WhatsApp Cloud API (Meta direct) — official Graph API integration for messages, media, and templates",
+  "description": "MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/communication/whatsapp-cloud"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-whatsapp-cloud",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -47,5 +47,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.developers.facebook.com",
+    "logoUrl": "https://logo.clearbit.com/developers.facebook.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=developers.facebook.com&sz=128",
+    "docsUrl": "https://developers.facebook.com/docs/whatsapp/cloud-api",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -113,9 +113,14 @@ async function whatsappRequest(
   return text ? JSON.parse(text) : {};
 }
 
+// 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-whatsapp-cloud", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-whatsapp-cloud", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -684,7 +689,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-whatsapp-cloud", version: "0.2.0" }, { capabilities: { tools: {} } });
+        const s = new Server({ name: "mcp-whatsapp-cloud", 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);