Add email debugging capabilities to your AI coding agent

Connect Claude Code and other AI agents to Mockmail via the Model Context Protocol (MCP). Automatically test, verify, and debug emails during development without the risk of sending messages to real customers.

Register Now Documentation

Free forever No credit card required

What is the Model Context Protocol (MCP)?

MCP is an open protocol that enables AI tools to securely access external data sources and tools. With Mockmail's MCP server, your AI coding agent can programmatically access and analyze test emails.

AI-Native Integration

Designed specifically for AI agents like Claude Code to seamlessly interact with your email testing infrastructure.

Secure Access

Token-based authentication ensures your AI agent only accesses your authorized inboxes and emails.

Standard Protocol

Based on JSON-RPC 2.0, making it easy to integrate with any MCP-compatible AI tool or framework.

Available MCP Tools

Three powerful tools to give your AI agent complete email testing capabilities

List inboxes

Retrieves all debug inboxes accessible to your account. Perfect for discovering available test environments.

Returns:
  • Inbox names and IDs
  • Email counts and limits
  • SMTP credentials
  • Webhook configurations
List emails

Lists emails in a specific inbox with pagination and search. Filter by subject to find specific test emails.

Features:
  • Pagination support (offset/limit)
  • Subject-based search
  • Attachment metadata
  • Read/unread status
Inspect email contents

Retrieves full email content in HTML or plain text format. Essential for verifying email templates and content.

Options:
  • HTML or plain text format
  • Full email headers
  • Attachment details and sizes
  • Sender/recipient information

AI-Powered Email Testing Use Cases

Let your AI coding agent handle email testing autonomously with a Mockmail debug email inbox.

Automated Test Verification

Ask your AI agent to verify that password reset emails are being sent correctly, with the right content and links.

Template Validation

Have your AI assistant check email templates for broken HTML, missing variables, or formatting issues.

Debugging Email Flows

Ask your AI to track email sequences (signup confirmation; welcome email; onboarding) and verify the complete flow.

Content Extraction

Extract verification codes, magic links, or other data from test emails without manual intervention.

CI/CD Integration

Integrate AI-powered email checks into your deployment pipeline for automated quality assurance.

Multi-Language Testing

Verify that internationalized emails render correctly in different languages and character sets.

Quick Setup

Add Mockmail MCP server to your AI coding assistant in seconds

Run this command in your terminal to add the Mockmail MCP server to Claude Code:

claude mcp add --transport http mockmail https://mockmail.io/mcp/mockmail \
  --header "Authorization: Bearer your-token"

Replace your-token with your API token from the Dashboard.

Add the Mockmail MCP server to your Cline MCP settings file:

Open VS Code Settings → Extensions → Cline → Edit MCP Settings

{
  "mcpServers": {
    "mockmail": {
      "url": "https://mockmail.io/mcp/mockmail",
      "transport": {
        "type": "http"
      },
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_API_TOKEN_HERE with your API token from the Dashboard. Restart VS Code after saving.

Next Steps: After configuration, your AI agent will automatically discover the three available tools (list-inboxes, list-emails, get-email-content) and can start testing emails immediately.
Ready to improve your email testing workflow?
Forever Free Plan. No Credit Card Required.
Register