@truncus/mcp-server

@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 [e-mail] from [e-mail] with subject 'Welcome aboard!'"

Claude will use truncus_send_email to deliver it.

Links

• Dashboard
• API Reference
• Get API Key