@codespar/mcp-evolution-api 0.2.0 → 0.2.2

package/README.md

@@ -51,10 +51,10 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
+## Tools (25)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `send_text` | Send a text message via WhatsApp |
 | `send_image` | Send an image message via WhatsApp |
 | `send_document` | Send a document via WhatsApp |
@@ -65,6 +65,21 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 | `send_poll` | Send a poll message via WhatsApp |
 | `get_messages` | Get messages from a chat |
 | `check_number` | Check if a phone number is registered on WhatsApp |
+| `create_group` | Create a WhatsApp group |
+| `get_group_info` | Get group metadata, participants, and settings |
+| `update_profile` | Update instance profile (name, status text, or picture) |
+| `set_presence` | Set online/offline presence for an instance |
+| `get_chat_history` | Get full chat history with pagination support |
+| `logout_instance` | Logout an instance (disconnects the WhatsApp session without deleting the instance) |
+| `restart_instance` | Restart an instance |
+| `delete_instance` | Delete an instance permanently |
+| `connection_state` | Get the connection state of an instance (open, connecting, close) |
+| `leave_group` | Leave a WhatsApp group |
+| `update_group_participants` | Add, remove, promote, or demote participants in a WhatsApp group |
+| `fetch_group_invite_code` | Fetch the invite code/link for a WhatsApp group |
+| `mark_message_as_read` | Mark one or more messages in a chat as read |
+| `archive_chat` | Archive or unarchive a chat |
+| `delete_message` | Delete a message for me or for everyone in a chat |
 
 ## Authentication
 
@@ -102,13 +117,13 @@ Evolution API is self-hosted. Deploy your own instance using Docker for testing.
 - `template_messages` — Send WhatsApp Business template messages
 - `label_management` — Create, update, and assign labels to chats
 
-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
 
 - [Evolution API Documentation](https://doc.evolution-api.com)
 - [Evolution API GitHub](https://github.com/EvolutionAPI/evolution-api)
-- [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

@@ -55,7 +55,10 @@ async function evolutionRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-evolution-api", 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-evolution-api", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -520,7 +523,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-evolution-api", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-evolution-api", 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-evolution-api",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Evolution API — WhatsApp messaging, instances, contacts",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -3,16 +3,16 @@
   "name": "io.github.codespar/mcp-evolution-api",
   "description": "MCP server for Evolution API — WhatsApp messaging, instances, contacts",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/communication/evolution-api"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-evolution-api",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -26,5 +26,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.evolution-api.com",
+    "logoUrl": "https://logo.clearbit.com/evolution-api.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=evolution-api.com&sz=128",
+    "docsUrl": "https://doc.evolution-api.com",
+    "sandbox": {
+      "available": false
+    }
+  }
 }

package/src/__tests__/index.test.ts

@@ -33,9 +33,9 @@ beforeEach(async () => {
 });
 
 describe("mcp-evolution-api", () => {
-  it("should register 15 tools", async () => {
+  it("should register 25 tools", async () => {
     const result = await listToolsHandler();
-    expect(result.tools).toHaveLength(15);
+    expect(result.tools).toHaveLength(25);
   });
 
   it("should call correct API endpoint for send_text", async () => {

package/src/index.ts

@@ -63,9 +63,14 @@ async function evolutionRequest(method: string, path: string, body?: unknown): P
   return res.json();
 }
 
+// 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-evolution-api", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-evolution-api", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -521,7 +526,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-evolution-api", 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-evolution-api", 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 });