Package Exports

@truncus/mcp-server
@truncus/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@truncus/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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 alice@example.com from noreply@mail.yourdomain.com with subject 'Welcome aboard!'"

Claude will use truncus_send_email to deliver it.