@truncus/mcp-server

MCP (Model Context Protocol) server for Truncus Email. Lets AI agents send transactional emails via Claude Desktop, Cursor, and any MCP-compatible client.

Installation

npm install -g @truncus/mcp-server

Claude Desktop Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "truncus": {
      "command": "truncus-mcp",
      "env": {
        "TRUNCUS_API_KEY": "tr_live_your_api_key"
      }
    }
  }
}

Or run without installing:

{
  "mcpServers": {
    "truncus": {
      "command": "npx",
      "args": ["-y", "@truncus/mcp-server"],
      "env": {
        "TRUNCUS_API_KEY": "tr_live_your_api_key"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | truncus_send_email | Send a transactional email | | truncus_validate_email | Validate payload without sending (dry-run) | | truncus_get_email | Get email status and engagement metrics | | truncus_get_stats | Get sending statistics | | truncus_list_domains | List verified sending domains | | truncus_check_suppression | Check if an email is suppressed |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TRUNCUS_API_KEY | Yes | Your API key from the Truncus dashboard | | TRUNCUS_BASE_URL | No | Override API base URL (default: https://truncus.co/api/v1) |

Example Usage

Once configured, ask Claude:

"Send a welcome email to [email protected] from [email protected] with subject 'Welcome aboard!'"

Claude will use truncus_send_email to deliver it.

Links

• Dashboard
• API Reference
• Get API Key