home / mcp / sitecore send mcp server

Sitecore Send MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "izharikov-send-mcp": {
      "command": "npx",
      "args": [
        "send-mcp"
      ],
      "env": {
        "API_KEY": "YOUR_SITECORE_SEND_API_KEY",
        "SMTP_FROM": "[email protected]",
        "SMTP_USER": "smtp_user",
        "SMTP_ENABLED": "true",
        "SMTP_PASSWORD": "smtp_password",
        "TRANSACTIONAL_EMAILS_CAMPAIGN_ID": "YOUR_CAMPAIGN_ID"
      }
    }
  }
}

The Sitecore Send MCP Server lets you integrate Sitecore Send capabilities into your MCP client workflows. It exposes email list management and transactional email sending through a lightweight MCP service you can run locally or connect to remotely, enabling automated email campaigns and recipient management from your applications.

How to use

You can run this MCP server locally and connect your MCP client to it via the stdio interface. Use the provided command to start the server, and supply required environment variables to enable SMTP and API access. Once running, you can call the available endpoints to manage lists, members, and to send transactional emails. The server is designed to be invoked with a single, simple command and works well in development or integration scenarios.

How to install

Prerequisites you need before installation: Node.js and npm (or npx is available with npm). Ensure you have a recent LTS version of Node.js installed on your system.

1. Create your MCP server configuration file with the stdio entry shown below.

2. Start the MCP server using the command in the configuration.

3. If you are using SMTP or API features, set the required environment variables before starting the server.

Complete steps with configuration and start instructions are provided in the code block below. Use them as a ready-to-run template.

{
  "mcpServers": {
    "send_mcp": {
      "command": "npx",
      "args": ["send-mcp"],
      "env": {
        "API_KEY": "YOUR_SITECORE_SEND_API_KEY",
        "TRANSACTIONAL_EMAILS_CAMPAIGN_ID": "YOUR_CAMPAIGN_ID",
        "SMTP_ENABLED": "true",
        "SMTP_FROM": "[email protected]",
        "SMTP_USER": "smtp_user",
        "SMTP_PASSWORD": "smtp_password"
      }
    }
  }
}
```

Note: This configuration starts the MCP server in stdio mode using npx to run the send-mcp package with the provided environment variables. Replace placeholder values with your actual API key, campaign ID, and SMTP credentials before starting the server.

Additional setup and configuration

Environment variables you can set to enable features are listed below. These are the keys used in the configuration example. You can adjust them to your environment as needed.

- API_KEY: Your Sitecore Send API key for authenticating API calls.

- TRANSACTIONAL_EMAILS_CAMPAIGN_ID: The campaign ID used for transactional emails.

- SMTP_ENABLED: Set to true to enable SMTP-based sending.

- SMTP_FROM: The From address to use when sending SMTP emails.

- SMTP_USER: The SMTP user for authentication.

- SMTP_PASSWORD: The SMTP password for authentication.

Available tools

get_lists

Fetch available email lists from Sitecore Send.

get_list_members

Retrieve members of a specific email list.

add_list_member

Add a member to an email list.

remove_list_member

Remove a member from an email list.

send_transactional_email

Send a transactional email using the configured service.

send_smtp_email

Send an email via SMTP using configured SMTP settings.