@codespar/mcp-sendgrid 0.2.0 → 0.2.1

package/README.md

@@ -9,21 +9,30 @@ SendGrid is Twilio-owned (acquired 2019). Together with [`@codespar/mcp-twilio`]
 
 Agents building commerce notification flows — order confirmations, shipping updates, abandoned-cart nudges, promos — can now cover every channel through two packages.
 
-## Tools
+## Tools (20)
 
 | Tool | Purpose |
-|------|---------|
-| `send_mail` | `POST /mail/send` — personalizations, content, attachments, scheduling |
-| `send_template` | `POST /mail/send` using a dynamic template (`d-...`) — convenience wrapper |
-| `add_contact` | `PUT /marketing/contacts` — upsert contacts (async job), assign to lists |
-| `list_contacts` | `GET /marketing/contacts` — sample of contacts |
-| `delete_contact` | `DELETE /marketing/contacts?ids=...` — delete by id or wipe all |
-| `search_contacts` | `POST /marketing/contacts/search` — SGQL (SendGrid SQL-like) query |
-| `list_templates` | `GET /templates` — dynamic (default) or legacy transactional templates |
-| `create_template` | `POST /templates` — create a transactional template |
-| `list_suppressions` | `GET /asm/groups/{group_id}/suppressions` — suppressed emails for a group |
-| `add_suppression` | `POST /asm/groups/{group_id}/suppressions` — add suppressions |
-| `get_stats` | `GET /stats` — sent / delivered / opens / clicks aggregated by day/week/month |
+|---|---|
+| `send_mail` | Send an email via POST /mail/send. |
+| `send_template` | Convenience wrapper for POST /mail/send with a dynamic template. |
+| `add_contact` | Upsert contacts in Marketing Campaigns via PUT /marketing/contacts. |
+| `list_contacts` | List Marketing Campaigns contacts via GET /marketing/contacts. |
+| `delete_contact` | Delete contacts by id via DELETE /marketing/contacts?ids=.... |
+| `search_contacts` | Search contacts with an SGQL query via POST /marketing/contacts/search. |
+| `get_contact` | Retrieve a single Marketing Campaigns contact by id via GET /marketing/contacts/{id}. |
+| `list_lists` | List all Marketing Campaigns contact lists via GET /marketing/lists. |
+| `create_list` | Create a Marketing Campaigns contact list via POST /marketing/lists. |
+| `delete_list` | Delete a Marketing Campaigns contact list via DELETE /marketing/lists/{id}. |
+| `list_templates` | List transactional templates via GET /templates. |
+| `create_template` | Create a transactional template via POST /templates. |
+| `list_suppressions` | List all suppressed recipients for an unsubscribe group via GET /asm/groups/{group_id}/suppressions. |
+| `add_suppression` | Add recipients to a suppression group via POST /asm/groups/{group_id}/suppressions. |
+| `list_unsubscribe_groups` | List all unsubscribe groups on the account via GET /asm/groups. |
+| `get_bounces` | Retrieve bounced recipients via GET /suppression/bounces. |
+| `delete_bounce` | Remove a bounced address from the bounce suppression list via DELETE /suppression/bounces/{email}. |
+| `cancel_scheduled_send` | Cancel or pause a scheduled send by batch_id via POST /user/scheduled_sends. |
+| `get_event_webhook_settings` | Retrieve the Event Webhook configuration via GET /user/webhooks/event/settings. |
+| `get_stats` | Global email stats via GET /stats. |
 
 ## Install
 

package/dist/index.js

@@ -92,7 +92,7 @@ function buildQuery(params) {
     const s = q.toString();
     return s ? `?${s}` : "";
 }
-const server = new Server({ name: "mcp-sendgrid", version: "0.2.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-sendgrid", version: "0.2.1" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -518,7 +518,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-sendgrid", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-sendgrid", 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-sendgrid",
-  "version": "0.2.0",
-  "description": "MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.",
+  "version": "0.2.1",
+  "description": "MCP server for SendGrid \u2014 global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {

package/server.json

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

package/src/index.ts

@@ -105,7 +105,7 @@ function buildQuery(params: Record<string, unknown>): string {
 }
 
 const server = new Server(
-  { name: "mcp-sendgrid", version: "0.2.0" },
+  { name: "mcp-sendgrid", version: "0.2.1" },
   { capabilities: { tools: {} } }
 );
 
@@ -512,7 +512,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-sendgrid", version: "0.2.0" }, { capabilities: { tools: {} } });
+        const s = new Server({ name: "mcp-sendgrid", 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);