Skip to content
MCP server

SendMock

Local sandbox that catches test email, SMS, payments and webhooks for developers

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Linux, Windows
Runs
Locally
Version
1.2.0
Listing updated
today

Similar MCP servers

About SendMock

SendMock is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

The README says SendMock sits between your app and the services it calls, so messages from email, SMS, push and payment integrations land on your own machine instead of real inboxes, phones or card networks. Your app keeps its existing provider SDKs and only needs its base URL or SMTP host changed.

Caught messages appear in a web UI and a REST API, where codes and links can be pulled out for automated tests. It can also fire signed webhooks back to your localhost app on demand or through rules, which lets you exercise webhook handlers without a tunnel or a provider sandbox.

It suits developers and QA engineers who build sign-up, OTP or checkout flows and want repeatable tests. It is also exposed to AI coding agents through a CLI, an MCP server and an agent skill.

Install

Run in a terminal

claude mcp add sendmock --env SENDMOCK_TOKEN='<SENDMOCK_TOKEN>' -- npx -y sendmock

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sendmock": {
      "command": "npx",
      "args": [
        "-y",
        "sendmock"
      ],
      "env": {
        "SENDMOCK_TOKEN": "<SENDMOCK_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sendmock": {
      "command": "npx",
      "args": [
        "-y",
        "sendmock"
      ],
      "env": {
        "SENDMOCK_TOKEN": "<SENDMOCK_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "sendmock": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sendmock"
      ],
      "env": {
        "SENDMOCK_TOKEN": "<SENDMOCK_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sendmock": {
      "command": "npx",
      "args": [
        "-y",
        "sendmock"
      ],
      "env": {
        "SENDMOCK_TOKEN": "<SENDMOCK_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sendmock": {
      "command": "npx",
      "args": [
        "-y",
        "sendmock"
      ],
      "env": {
        "SENDMOCK_TOKEN": "<SENDMOCK_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SENDMOCK_SERVERThe running SendMock to talk to
  • SENDMOCK_TOKENAPI token, when the server has UI auth on
  • SENDMOCK_MCP_TOOLSETSToolsets to expose, comma-separated, or all
  • SENDMOCK_SERVERThe running SendMock to talk to, as the container reaches it
  • SENDMOCK_TOKENAPI token, when the server has UI auth on
  • SENDMOCK_MCP_TOOLSETSToolsets to expose, comma-separated, or all

What it does

Email capture over SMTP
Catches messages sent over SMTP and shows HTML, text and source previews with link and spam checks.
SMS and verification codes
Emulates Twilio and Vonage style APIs and extracts one-time codes for tests.
Provider-compatible payments
Offers test checkouts for Stripe, PayPal, Razorpay, Paddle, bKash and SSLCommerz with simulated outcomes.
On-demand webhook delivery
Sends realistic, signed webhooks to localhost via rules, templates, manual sends and replay.
MCP server for agents
Lets AI agents read captured codes, configure webhooks and check delivery through MCP tools.
HTTP catcher bins
Captures any HTTP request and returns configured mock responses, delays or failures.

Good for

  • Test sign-up and password reset flows that send emails or one-time codes without a real inbox
  • Exercise webhook handlers for delivered, bounced or payment succeeded events on localhost
  • Run checkout and payment tests without a provider sandbox account
  • Let an AI coding agent read sent codes and verify messages during development

Pricing

Open source

Free and open source, dual-licensed Apache 2.0 or MIT.

Prices change. Check shibbirweb.github.io before you buy.

SendMock FAQ

Does anything reach a real inbox or phone?

The README says no message reaches a real inbox, phone or provider unless you set up a real relay and allow the recipient.

Do I need to change my application code?

According to the README, you change the host and port or base URL only, and provider SDKs keep working.

Which platforms does it run on?

The install options include macOS, Linux, Windows, Docker and npx or bunx, with a Docker image on GHCR.

Is SendMock free?

Yes. SendMock is open source, so you can use and self-host it for free.

How do I add SendMock to Claude Code?

Run this command in your terminal: claude mcp add sendmock --env SENDMOCK_TOKEN='<SENDMOCK_TOKEN>' -- npx -y sendmock

What are the best alternatives to SendMock?

The closest alternatives to SendMock are receivemail.dev, Agent Identity MCP, Dead Simple Email, SMB Sandbox and Mockanything.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers