Servidor MCP de SendGrid

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona acceso a la API de marketing de SendGrid para marketing por correo electrónico y gestión de contactos. https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api

Manifestación

En esta demostración, le pedimos al agente de SendGrid de Cline que cree una nueva lista de contactos, agregue mis correos electrónicos, genere automáticamente una plantilla con información sobre Ciudades Perdidas y envíe el correo electrónico a la lista. En este proceso, Cline se dará cuenta automáticamente de que necesita conocer los remitentes verificados y qué grupo de cancelación de suscripción usar. ¡Recibo un correo electrónico atractivo en mi bandeja de entrada, deleitándome con Ciudades Perdidas!

Nota importante sobre la compatibilidad con API

Este servidor es compatible exclusivamente con las API v3 de SendGrid y no ofrece compatibilidad con funciones heredadas. Esto incluye:

Solo plantillas dinámicas: no se admiten plantillas heredadas
API de marketing v3 para todas las operaciones de contactos y listas de contactos
API de envíos únicos para envíos masivos de correos electrónicos

Herramientas disponibles

Gestión de contactos

lista_contactos

Enumera todos los contactos en su cuenta de SendGrid.

// No parameters required

agregar_contacto

Agregue un contacto a sus contactos de marketing de SendGrid.

{
  email: string;           // Required: Contact email address
  first_name?: string;     // Optional: Contact first name
  last_name?: string;      // Optional: Contact last name
  custom_fields?: object;  // Optional: Custom field values
}

eliminar_contactos

Eliminar contactos de su cuenta de SendGrid.

{
  emails: string[];  // Required: Array of email addresses to delete
}

obtener_contactos_por_lista

Obtenga todos los contactos en una lista de SendGrid.

{
  list_id: string;  // Required: ID of the contact list
}

Gestión de listas

lista_listas_de_contactos

Enumere todas las listas de contactos en su cuenta de SendGrid.

// No parameters required

crear_lista_de_contactos

Crear una nueva lista de contactos en SendGrid.

{
  name: string;  // Required: Name of the contact list
}

lista_de_eliminar

Eliminar una lista de contactos de SendGrid.

{
  list_id: string;  // Required: ID of the contact list to delete
}

agregar contactos a la lista

Agregar contactos a una lista de SendGrid existente.

{
  list_id: string;    // Required: ID of the contact list
  emails: string[];   // Required: Array of email addresses to add
}

eliminar_contactos_de_la_lista

Eliminar contactos de una lista de SendGrid sin eliminarlos.

{
  list_id: string;    // Required: ID of the contact list
  emails: string[];   // Required: Array of email addresses to remove
}

Envío de correo electrónico

enviar_correo electrónico

Envíe un correo electrónico utilizando SendGrid.

{
  to: string;                             // Required: Recipient email address
  subject: string;                        // Required: Email subject line
  text: string;                          // Required: Plain text content
  from: string;                          // Required: Verified sender email address
  html?: string;                         // Optional: HTML content
  template_id?: string;                  // Optional: Dynamic template ID
  dynamic_template_data?: object;        // Optional: Template variables
}

enviar_a_la_lista

Envíe un correo electrónico a una lista de contactos utilizando SendGrid Single Sends.

{
  name: string;                          // Required: Name of the single send
  list_ids: string[];                    // Required: Array of list IDs to send to
  subject: string;                       // Required: Email subject line
  html_content: string;                  // Required: HTML content
  plain_content: string;                 // Required: Plain text content
  sender_id: number;                     // Required: ID of the verified sender
  suppression_group_id?: number;         // Required if custom_unsubscribe_url not provided
  custom_unsubscribe_url?: string;       // Required if suppression_group_id not provided
}

Gestión de plantillas (solo plantillas dinámicas)

crear_plantilla

Crear una nueva plantilla de correo electrónico dinámica.

{
  name: string;           // Required: Name of the template
  subject: string;        // Required: Default subject line
  html_content: string;   // Required: HTML content with handlebars syntax
  plain_content: string;  // Required: Plain text content with handlebars syntax
}

plantillas de lista

Enumere todas las plantillas de correo electrónico dinámicas.

// No parameters required

obtener_plantilla

Recuperar una plantilla por ID.

{
  template_id: string;  // Required: ID of the template to retrieve
}

eliminar_plantilla

Eliminar una plantilla dinámica.

{
  template_id: string;  // Required: ID of the template to delete
}

Análisis y validación

obtener_estadísticas

Obtenga estadísticas de correo electrónico de SendGrid.

{
  start_date: string;                          // Required: Start date (YYYY-MM-DD)
  end_date?: string;                           // Optional: End date (YYYY-MM-DD)
  aggregated_by?: 'day' | 'week' | 'month';    // Optional: Aggregation period
}

validar_correo electrónico

Validar una dirección de correo electrónico utilizando SendGrid.

{
  email: string;  // Required: Email address to validate
}

Gestión de cuentas

lista_de_remitentes_verificados

Enumere todas las identidades de remitentes verificadas.

// No parameters required

lista_de_grupos_de_supresión

Enumere todos los grupos cancelados de suscripción.

// No parameters required

Instalación

git clone https://github.com/Garoth/sendgrid-mcp.git
cd sendgrid-mcp
npm install

Configuración

Obtenga su clave API de SendGrid:
- Inicie sesión en su cuenta de SendGrid
- Vaya a Configuración > Claves API
- Cree una nueva clave API con permisos de acceso completo
- Guarde la clave API de forma segura, ya que no se volverá a mostrar.
Agréguelo a su archivo de configuración de Cline MCP dentro de la configuración de VSCode (por ejemplo, ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "sendgrid": {
      "command": "node",
      "args": ["/path/to/sendgrid-mcp/build/index.js"],
      "env": {
        "SENDGRID_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": [
        "list_contacts",
        "list_contact_lists",
        "list_templates",
        "list_single_sends",
        "get_single_send",
        "list_verified_senders",
        "list_suppression_groups",
        "get_stats",
        "validate_email"
      ]
    }
  }
}

Nota: Las herramientas que modifican datos (como enviar correos electrónicos o eliminar contactos) se excluyen intencionalmente de la aprobación automática por seguridad.

Desarrollo

Configuración de pruebas

Las pruebas utilizan llamadas API reales para garantizar respuestas precisas. Para ejecutar las pruebas:

Copie el archivo de entorno de ejemplo:
cp .env.example .env
Edite .env y agregue su clave API de SendGrid:
SENDGRID_API_KEY=your-api-key-here
Nota: El archivo .env se ignora para evitar enviar información confidencial.
Ejecutar las pruebas:
npm test

Edificio

npm run build

Notas importantes

Al enviar correos electrónicos a listas, debe proporcionar un suppression_group_id o un custom_unsubscribe_url para cumplir con las regulaciones de correo electrónico.
Las direcciones de correo electrónico del remitente deben verificarse con SendGrid antes de poder usarse para enviar correos electrónicos.
Todas las plantillas se crean como plantillas dinámicas con soporte para la sintaxis de handlebars (por ejemplo, {{variable_name}})
La API de envíos únicos se utiliza para todas las operaciones de correo electrónico masivo, ya que proporciona mejores capacidades de seguimiento y gestión.
La API de SendGrid es "eventualmente consistente": los cambios de datos (como agregar contactos o actualizar listas) pueden no aparecer inmediatamente después de realizarse.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Derechos de autor del logotipo de SendGrid / propiedad de Twilio

Integrations