SpamTitan

Official

by wyre-technology · TypeScript

MCP server for SpamTitan email security — quarantine, allow/block lists, and policy management.

Manages email security with quarantine, allow/block lists, and policy controls.

Topics

email-securitymcp-servermspspamtitantypescriptwyre-technologymsp-mcp

README.md2 KBView on GitHub

SpamTitan MCP Server

A Model Context Protocol (MCP) server for SpamTitan email security. Enables AI assistants to manage quarantine, maintain allowlists and blocklists, and view email filtering statistics.

This is a Model Context Protocol (MCP) server that connects Claude (or any MCP-compatible AI) to your SpamTitan environment.

Part of the MSP Claude Plugins ecosystem — a growing suite of AI integrations for the MSP stack. Built by MSPs, for MSPs.

Installation

bash

npm install @wyre-technology/spamtitan-mcp

Configuration

Set the following environment variables:

Variable	Required	Description
`SPAMTITAN_API_KEY`	Yes	Your SpamTitan API key
`SPAMTITAN_BASE_URL`	No	Your SpamTitan instance URL
`MCP_TRANSPORT`	No	Transport mode: stdio (default) or http

Usage

Running with Claude Desktop

Add to your Claude Desktop claude_desktop_config.json:

json

{
  "mcpServers": {
    "spamtitan-mcp": {
      "command": "npx",
      "args": ["@wyre-technology/spamtitan-mcp"],
      "env": {
        "SPAMTITAN_API_KEY": "your-spamtitan-api-key"
      }
    }
  }
}

Running with Claude Code (CLI)

bash

claude mcp add spamtitan-mcp \
  -e SPAMTITAN_API_KEY=your-value \
  -- npx -y @wyre-technology/spamtitan-mcp

Docker

bash

docker build -t spamtitan-mcp .
docker run \
  -e SPAMTITAN_API_KEY=your-value \
  -p 8080:8080 spamtitan-mcp

Available Domains

Lists

Manage allowlists and blocklists

Quarantine

Email quarantine review and management

Stats

Email filtering statistics and reports

Development

bash

# Clone the repository
git clone https://github.com/wyre-technology/spamtitan-mcp.git
cd spamtitan-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

Contributing

Contributions are welcome! Please see CONTRIBUTING.md if present, or open an issue to discuss changes.

License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

Install

Configuration

Environment variables

SPAMTITAN_API_URLrequired

SpamTitan API base URL (e.g. https://spamtitan.example.com/api)

SPAMTITAN_API_KEYrequiredsecret

SpamTitan API key for authentication

MCP_TRANSPORTdefault stdio

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

AUTH_MODEdefault env

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.

LOG_LEVELdefault info

Log verbosity: debug, info, warn, error

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "spamtitan-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/spamtitan-mcp:v1.2.4"
      ],
      "env": {
        "SPAMTITAN_API_URL": "<YOUR_SPAMTITAN_API_URL>",
        "SPAMTITAN_API_KEY": "<YOUR_SPAMTITAN_API_KEY>",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}