Blastengine-mailer

Sends emails via the Blastengine API using an MCP server accessible from your MCP clients.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "r3-yamauchi-mcp-server-blastengine-mailer": {
      "command": "node",
      "args": [
        "/path/to/blastengine-mailer/server.js"
      ],
      "env": {
        "BLASTENGINE_API_KEY": "apikey-of-blastengine",
        "BLASTENGINE_USER_ID": "userid-of-blastengine"
      }
    }
  }
}

You run a lightweight MCP server that uses the Blastengine API to send emails on behalf of your LLM or other MCP clients. It exposes a simple tool you can call to deliver messages and returns a delivery identifier on success or a detailed error when something goes wrong.

How to use

You connect to this MCP server from an MCP client and call the send_email tool. Provide the required fields to compose your message: to for the recipient, from for the sender, subject for the message title, and text for the body. If the email is sent successfully, you receive a delivery_id. If there is an error, you receive a detailed error message to help you diagnose the issue.

How to install

Prerequisites: Node.js with ES module support and a Blastengine API account with a valid API key.

Install dependencies, build, and run in development mode.

npm install

npm run build

npm run watch

Configure and run with Claude Desktop

To use Claude Desktop, add the MCP server configuration to your Claude desktop settings. Create a server entry for blastengine-mailer that runs with Node and passes your Blastengine credentials as environment variables.

Example configuration (placeholders shown):

{
  "mcpServers": {
    "blastengine-mailer": {
      "command": "node",
      "env": {
        "BLASTENGINE_USER_ID": "userid-of-blastengine",
        "BLASTENGINE_API_KEY": "apikey-of-blastengine"
      },
      "args": [
        "/path/to/blastengine-mailer/server.js"
      ]
    }
  }
}

Debug

MCP servers communicate over stdio, which can make debugging tricky. Use the MCP Inspector to attach debugging tools and inspect the interaction with a browser-based tool.

npm run inspector

Usage example

After configuring Claude Desktop, you can issue a command to send an email, for example: “send an email to test@example.com with the subject Test Mail and body content.” The server will process the request and return a delivery_id on success.

Notes and troubleshooting

This server requires Blastengine credentials to be provided as environment variables. Ensure the BLASTENGINE_USER_ID and BLASTENGINE_API_KEY are correctly set. If you encounter errors, check the returned error message for hints about authentication, quota, or invalid parameters.

Available tools

send_email

Sends an email using the Blastengine API. Requires to, from, subject, and text. Returns a delivery_id on success or a detailed error on failure.