Xeams MCP Server

An MCP server implementation for Xeams, an on-premise email server.

Features

• Exposes a Model Context Protocol (MCP) server for querying email status on an on-premise email server.

• This MCP server works with Xeams, an on-premise email server with %100 privacy.

• You can use this server with any MCP client, or AI tools such as Claude Desktop to:

  • Validate email addresses

  • Check the status of outbound emails sent.

  • Check the Xeams server's health, uptime, memory and disk usage, and queue counts.

  • Search for emails processed by Xeams.

  • Fetch the raw MIME (*.eml) content, body, or attachments of a specific email.

Related MCP server: email-verify

Requirement

• Xeams server, version 9.9 or newer

• Node.js

Setup

1. Clone the repository:

   git clone https://github.com/Synametrics/xeams-mcp-server
   cd xeams-mcp-server

2. Install dependencies

   npm install

3. Configure environment variables:

• Copy .env.sample to .env:

   cp .env.sample .env

• Edit .env and fill in your Xeams API and Secret.

  Variable	Description	Required
  XEAMS_API_KEY	Xeams API Key	Yes
  XEAMS_SECRET	Xeams API Secret	Yes
  XEAMS_API_BASE	URL for your Xeams server	Yes
  SENDER_EMAIL	Email address used for sender's address.	Yes

4. Configuring Xeams

• Download and install Xeams if needed, from https://www.xeams.com

• Log into your Xeams console with your administrator's credentials

• Click Home > Plugins, and click the Manage button for Xeams API

• Create new API Key and grant permission to send emails.

• Copy the generated API key and secret to the environment file seen above.

Running the MCP Server

Use the following command to run the server manually:

node index.js

Testing Communication with Xeams

To ensure your API key and secret values are working, use the --test parameter, as shown below.

node index.js --test

Use Case

Imagine you're working on implementing a Chatbot for your organization where your customers can ask questions about their recent orders. Using this MCP server, you can query your email server to determine if an email containing the recent purchase and order confirmation was sent to the client and if the recipient's SMTP server received the message.

Additionally, you can also confirm if an email address specified by a user is correct. This check is more than a simple syntax check. The MCP server actually connects to the recipient's SMTP server to confirm the user exists.

You can also use this server for administrative and support tasks, such as checking whether the Xeams server itself is healthy, searching for a specific email a customer says they sent or received, and pulling up that email's raw content, body, or attachments for troubleshooting.

Configuration with Claude Desktop

To install this MCP server using Claude Desktop, follow the steps below.

• Download and install Claude Desktop from https://www.claude.com/download.

• Click *File > Settings after clicking the hamburger icon on the upper left hand corner.

• Click Edit Config

• Copy/paste the following JSON snippet into the claude_desktop_config.json file.

{
  "mcpServers": {
    "Xeams-MCP-Server": {
      "command": "node",
      "args": ["C:\\path\\to\\the\\downloaded\\file\\index.js"],
      "env": {
        "XEAMS_API_KEY": "YourAPIKey",
        "XEAMS_SECRET": "YourAPISecret",
        "XEAMS_API_BASE": "https://mail.yourserver.com",
        "SENDER_EMAIL": "you@yourcompany.com"
      }
    }
  }
}

• Restart Claude

Once done, you should be able to submits prompts like:

Please confirm if john.doe@example.com is a valid email address.

I sent an email to aFriend@example.com yesterday. Did he get my message?

Available tools

This MCP server exposes the following tools to any MCP client:

1. ValidateAddress - Validates if an email address is correct. This validation is more than a simple syntax check. It confirms the domain name has an MX record and the user's address exists in the recipient's server.

2. CheckEmailStatus - Confirms the status of a previously sent email. In this case, it will report the status of the message, the IP address of the receiving SMTP server and if encryption was used.

3. GetServerStatus - Fetches the Xeams server's status, including uptime, memory usage, disk space, and email queue counts (incoming/outgoing counts, stuck/processing queue sizes).

4. SearchEmails - Searches for emails processed by Xeams matching a search string, optionally scoped to a number of days back and a profile ID. Returns matching messages (subject, sender, recipients, date, score) along with their lcid/clusterIndex, which identify the message for use with the fetch tools below.

5. FetchEmailRaw - Fetches the raw MIME content (*.eml) of a specific email, encoded in base64. Contains headers, body and attachments. Takes the lcid (and optional clusterIndex/profileId/startingDate) returned by SearchEmails.

6. FetchEmailBody - Fetches just the body of a specific email, encoded in base64. HTML body is preferred over plain text when both are present.

7. FetchEmailAttachments - Fetches the attachments of a specific email. Each attachment's content is base64 encoded, along with its file name and MIME type.