Release v0.2.0

Author: mklocek

CHANGELOG.md

@@ -1,8 +1,18 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-03-30
+
+* Add **sandbox project & inbox management** tools: **list-sandbox-projects**, **create-sandbox-project**, **delete-sandbox-project**, **create-sandbox-inbox**, **get-sandbox-inbox**, **update-sandbox-inbox**, **delete-sandbox-inbox**, **clean-sandbox-inbox**.
+* Extend **show-sandbox-email-message** tool with spam report (SpamAssassin score) and HTML analysis (client compatibility).
+* Add read-only annotations to **get-sandbox-messages** and **show-sandbox-email-message**.
 * Add **list-email-logs** and **get-email-log-message** tools: query sent-mail delivery history with filters and pagination; inspect a single log by UUID (summary, event timeline, optional body via `include_content`).
 * Add **get-sending-stats** tool: check delivery, bounce, open, click, and spam rates for a date range; optional breakdown by domain, category, email service provider, or date.
 * Add **sending domains** tools: **list-sending-domains**, **get-sending-domain**, **create-sending-domain**, **delete-sending-domain**. **get-sending-domain** accepts optional `include_setup_instructions: true` to append DNS setup instructions to the response.
+* Make `DEFAULT_FROM_EMAIL` and `MAILTRAP_TEST_INBOX_ID` config/env params optional so that it's possible to change them in runtime.
+* Reuse `requireClient` helper to reduce client setup validation boilerplate across tools.
+* Bump `mailtrap` SDK to 4.5.1.
+* Update manifest.json tools list to reflect all 23 available tools.
+* Dependency updates.
 
 ## [0.1.0] - 2025-12-09
 

manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.2",
   "name": "mailtrap-mcpb",
   "display_name": "Mailtrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Send emails and manage templates using Mailtrap",
   "long_description": "**[Mailtrap.io](https://mailtrap.io)** is a comprehensive email platform that helps developers and teams test, debug, and deliver emails safely. It provides both email testing (sandbox) and email delivery services. \n This MCP (Model Context Protocol) server provides AI assistants with the ability to: \n - **Send emails** via Mailtrap's delivery API \n - **Test emails** using Mailtrap's sandbox environment \n - **Manage email templates** (create, update, delete, list).",
   "author": {
@@ -36,14 +36,14 @@
       "name": "send-email",
       "description": "Send emails via Mailtrap's delivery API with support for HTML/text content and multiple recipients."
     },
-    {
-      "name": "send-sandbox-email",
-      "description": "Send test emails to Mailtrap's sandbox environment without delivering to real recipients."
-    },
     {
       "name": "create-template",
       "description": "Create a new email template in Mailtrap."
     },
+    {
+      "name": "list-templates",
+      "description": "List all email templates in your Mailtrap account."
+    },
     {
       "name": "update-template",
       "description": "Update an existing email template in Mailtrap."
@@ -53,8 +53,76 @@
       "description": "Delete an email template from Mailtrap."
     },
     {
-      "name": "list-templates",
-      "description": "List all email templates in your Mailtrap account."
+      "name": "send-sandbox-email",
+      "description": "Send test emails to Mailtrap's sandbox environment without delivering to real recipients."
+    },
+    {
+      "name": "get-sandbox-messages",
+      "description": "Get list of messages from the sandbox test inbox."
+    },
+    {
+      "name": "show-sandbox-email-message",
+      "description": "Show sandbox email message details and content, with optional spam report and HTML analysis."
+    },
+    {
+      "name": "list-sandbox-projects",
+      "description": "List all sandbox projects and their inboxes in your Mailtrap account."
+    },
+    {
+      "name": "create-sandbox-project",
+      "description": "Create a new sandbox project to group test inboxes."
+    },
+    {
+      "name": "delete-sandbox-project",
+      "description": "Delete a sandbox project and all its inboxes."
+    },
+    {
+      "name": "create-sandbox-inbox",
+      "description": "Create a new sandbox test inbox within a project."
+    },
+    {
+      "name": "get-sandbox-inbox",
+      "description": "Get sandbox inbox details including SMTP credentials, email counts, and status."
+    },
+    {
+      "name": "update-sandbox-inbox",
+      "description": "Update a sandbox inbox name or email username."
+    },
+    {
+      "name": "delete-sandbox-inbox",
+      "description": "Delete a sandbox inbox and all its messages."
+    },
+    {
+      "name": "clean-sandbox-inbox",
+      "description": "Delete all messages from a sandbox inbox without deleting the inbox itself."
+    },
+    {
+      "name": "get-sending-stats",
+      "description": "Get email sending statistics (delivery, bounce, open, click, spam rates) for a date range with optional breakdowns."
+    },
+    {
+      "name": "list-email-logs",
+      "description": "List sent email logs (delivery history) with optional pagination and filters."
+    },
+    {
+      "name": "get-email-log-message",
+      "description": "Get a single email log message by ID to inspect delivery status and event history."
+    },
+    {
+      "name": "list-sending-domains",
+      "description": "List sending domains and their DNS verification status."
+    },
+    {
+      "name": "get-sending-domain",
+      "description": "Get a sending domain by ID and its verification status, with optional DNS setup instructions."
+    },
+    {
+      "name": "create-sending-domain",
+      "description": "Create a new sending domain."
+    },
+    {
+      "name": "delete-sending-domain",
+      "description": "Delete a sending domain."
     }
   ],
   "prompts": [],

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-mailtrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official MCP Server for Mailtrap",
   "license": "MIT",
   "author": "Railsware Products Studio LLC",

package.json

@@ -1,5 +1,5 @@
 export default {
   MCP_SERVER_NAME: "mailtrap-mcp-server",
-  MCP_SERVER_VERSION: "0.1.0",
+  MCP_SERVER_VERSION: "0.2.0",
   USER_AGENT: "mailtrap-mcp (https://github.com/mailtrap/mailtrap-mcp)",
 };