@apteva/integrations 0.3.39 → 0.3.43

package/src/apps/sendgrid.json

@@ -1,13 +1,16 @@
 {
   "slug": "sendgrid",
   "name": "SendGrid",
-  "description": "MCP server for SendGrid - emails, templates, campaigns, lists",
+  "description": "MCP server for SendGrid email delivery, templates, campaigns, contact lists, and analytics",
   "logo": "https://www.google.com/s2/favicons?domain=sendgrid.com&sz=128",
   "categories": [
     "email",
     "marketing",
     "transactional",
-    "messaging"
+    "messaging",
+    "sendgrid",
+    "delivery",
+    "templates"
   ],
   "base_url": "https://api.sendgrid.com/v3",
   "auth": {
@@ -28,26 +31,73 @@
   "tools": [
     {
       "name": "send_email",
-      "description": "Send an email",
+      "description": "Send an email via SendGrid",
       "method": "POST",
       "path": "/send-email",
       "input_schema": {
         "type": "object",
         "properties": {
           "to": {
-            "type": "string"
+            "type": "array",
+            "description": "Recipient email addresses",
+            "items": {
+              "type": "object",
+              "properties": {
+                "email": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                }
+              }
+            }
           },
           "from": {
-            "type": "string"
+            "type": "object",
+            "description": "Sender information",
+            "properties": {
+              "email": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              }
+            }
           },
           "subject": {
-            "type": "string"
+            "type": "string",
+            "description": "Email subject"
           },
-          "text": {
-            "type": "string"
+          "content": {
+            "type": "array",
+            "description": "Email content",
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "value": {
+                  "type": "string"
+                }
+              }
+            }
           },
           "html": {
-            "type": "string"
+            "type": "string",
+            "description": "HTML content"
+          },
+          "text": {
+            "type": "string",
+            "description": "Plain text content"
+          },
+          "template_id": {
+            "type": "string",
+            "description": "SendGrid template ID"
+          },
+          "dynamic_template_data": {
+            "type": "object",
+            "description": "Template variables"
           }
         },
         "required": [
@@ -57,6 +107,131 @@
         ]
       }
     },
+    {
+      "name": "create_template",
+      "description": "Create a new email template in SendGrid",
+      "method": "POST",
+      "path": "/create-template",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Template name"
+          },
+          "generation": {
+            "type": "string",
+            "description": "Template generation",
+            "enum": [
+              "legacy",
+              "dynamic"
+            ],
+            "default": "dynamic"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      }
+    },
+    {
+      "name": "get_templates",
+      "description": "Retrieve email templates from SendGrid",
+      "method": "GET",
+      "path": "/get-templates",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "generations": {
+            "type": "string",
+            "description": "Template generation filter",
+            "enum": [
+              "legacy",
+              "dynamic"
+            ]
+          },
+          "page_size": {
+            "type": "integer",
+            "description": "Number of templates per page",
+            "default": 200,
+            "maximum": 200
+          }
+        }
+      }
+    },
+    {
+      "name": "add_contact",
+      "description": "Add a contact to SendGrid",
+      "method": "GET",
+      "path": "/add-contact",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "contacts": {
+            "type": "array",
+            "description": "Contact information",
+            "items": {
+              "type": "object",
+              "properties": {
+                "email": {
+                  "type": "string"
+                },
+                "first_name": {
+                  "type": "string"
+                },
+                "last_name": {
+                  "type": "string"
+                },
+                "custom_fields": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "list_ids": {
+            "type": "array",
+            "description": "List IDs to add contacts to",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "contacts"
+        ]
+      }
+    },
+    {
+      "name": "get_stats",
+      "description": "Retrieve email delivery statistics from SendGrid",
+      "method": "GET",
+      "path": "/get-stats",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "start_date": {
+            "type": "string",
+            "description": "Start date (YYYY-MM-DD)"
+          },
+          "end_date": {
+            "type": "string",
+            "description": "End date (YYYY-MM-DD)"
+          },
+          "aggregated_by": {
+            "type": "string",
+            "description": "Aggregation method",
+            "enum": [
+              "day",
+              "week",
+              "month"
+            ]
+          }
+        },
+        "required": [
+          "start_date"
+        ]
+      }
+    },
     {
       "name": "send_template",
       "description": "Send using a template",
@@ -136,29 +311,6 @@
         ]
       }
     },
-    {
-      "name": "get_stats",
-      "description": "Get email statistics",
-      "method": "GET",
-      "path": "/get-stats",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "start_date": {
-            "type": "string"
-          },
-          "end_date": {
-            "type": "string"
-          },
-          "aggregated_by": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "start_date"
-        ]
-      }
-    },
     {
       "name": "verify_sender",
       "description": "Verify sender identity",
@@ -187,5 +339,46 @@
         ]
       }
     }
-  ]
+  ],
+  "webhooks": {
+    "signature_header": "x-sendgrid-signature",
+    "events": [
+      {
+        "name": "email.processed",
+        "description": "Email accepted for delivery"
+      },
+      {
+        "name": "email.delivered",
+        "description": "Email delivered to recipient"
+      },
+      {
+        "name": "email.opened",
+        "description": "Email opened by recipient"
+      },
+      {
+        "name": "email.clicked",
+        "description": "Link clicked in email"
+      },
+      {
+        "name": "email.bounced",
+        "description": "Email bounced"
+      },
+      {
+        "name": "email.dropped",
+        "description": "Email dropped (suppressed)"
+      },
+      {
+        "name": "email.deferred",
+        "description": "Email delivery deferred"
+      },
+      {
+        "name": "email.spam_report",
+        "description": "Email marked as spam"
+      },
+      {
+        "name": "email.unsubscribe",
+        "description": "Recipient unsubscribed"
+      }
+    ]
+  }
 }

package/src/apps/socialcast.json

@@ -205,7 +205,7 @@
     },
     {
       "name": "create_post",
-      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links.\n\nMedia capabilities per platform:\n- Instagram: Single image, single video (Reel), or CAROUSEL (2-10 images/videos mixed). Pass multiple items in media_urls for carousel.\n- Facebook: Text, single image, MULTI-PHOTO (2+ images posted as album), single video, or link post.\n- Twitter/X: Text with up to 4 media attachments (images, GIFs, or 1 video). Media is uploaded automatically.\n- TikTok: Single video or PHOTO CAROUSEL (up to 35 images). Use overrides for privacy, comments, music.\n- YouTube: Single video upload with title, description, tags, privacy.\n- Pinterest: Single image with title, description, board, and link.\n- Reddit: Text (self) or link post to a subreddit.\n- LinkedIn: Text post with optional visibility setting.\n- Telegram: Text or single image with optional parse mode.\n\nTo schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York').",
+      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links.\n\nMedia capabilities per platform:\n- Instagram: Single image, single video (Reel), or CAROUSEL (2-10 images/videos mixed). Pass multiple items in media_urls for carousel.\n- Facebook: Text, single image, MULTI-PHOTO (2+ images posted as album), single video, or link post.\n- Twitter/X: Text with up to 4 media attachments (images, GIFs, or 1 video). Media is uploaded automatically.\n- TikTok: Single video or PHOTO CAROUSEL (up to 35 images). Use overrides for privacy, comments, music.\n- YouTube: Single video upload with title, description, tags, privacy.\n- Pinterest: Single image with title, description, board, and link.\n- Reddit: Text (self) or link post to a subreddit.\n- LinkedIn: Text post with optional visibility setting.\n- Telegram: Text or single image with optional parse mode.\n\nTo schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York'). IMPORTANT: Each call only accepts a single scheduled_for time that applies to ALL account_ids in that call. To schedule the same content at different times for different platforms (e.g., Instagram at 9am and Twitter at 12pm), you MUST make separate create_post calls — one per unique scheduled time, each with only the account_ids for that time slot.",
       "method": "POST",
       "path": "/posts",
       "input_schema": {
@@ -730,6 +730,18 @@
   ],
   "webhooks": {
     "signature_header": "x-webhook-signature",
+    "registration": {
+      "method": "POST",
+      "path": "/webhooks-register",
+      "url_field": "endpoint_url",
+      "events_field": "event_types",
+      "secret_field": "secret_key",
+      "id_field": "id",
+      "delete_path": "/webhooks/{id}",
+      "delete_method": "DELETE",
+      "list_path": "/webhooks",
+      "list_field": "data"
+    },
     "events": [
       {
         "name": "social.comment.received",