@codespar/mcp-sendgrid 0.2.0 → 0.2.2

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
 
@@ -82,6 +91,10 @@ MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sendgrid
 
 - [`@codespar/mcp-twilio`](../twilio) — SMS, WhatsApp, Voice, Verify, Lookup
 
+## 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

@@ -92,7 +92,10 @@ function buildQuery(params) {
     const s = q.toString();
     return s ? `?${s}` : "";
 }
-const server = new Server({ name: "mcp-sendgrid", 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-sendgrid", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -518,7 +521,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,6 +1,6 @@
 {
   "name": "@codespar/mcp-sendgrid",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.",
   "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-sendgrid",
-  "description": "MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.",
+  "description": "MCP server for SendGrid — global transactional + marketing email (Twilio-owned)",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/communication/sendgrid"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-sendgrid",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -33,5 +33,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.sendgrid.com",
+    "logoUrl": "https://logo.clearbit.com/sendgrid.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=sendgrid.com&sz=128",
+    "docsUrl": "https://docs.sendgrid.com",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -104,9 +104,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-sendgrid", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-sendgrid", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -512,7 +517,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);