Back to Browse

Sendmock MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Test email, SMS, payments and webhooks locally: read messages, OTPs and webhook deliveries.

About

Test email, SMS, payments and webhooks locally: read messages, OTPs and webhook deliveries.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved).

17 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

The running SendMock to talk toOptional

Environment variable: SENDMOCK_SERVER

API token, when the server has UI auth onRequired

Environment variable: SENDMOCK_TOKEN

Toolsets to expose, comma-separated, or allOptional

Environment variable: SENDMOCK_MCP_TOOLSETS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "sendmock": {
      "command": "npx",
      "args": [
        "-y",
        "sendmock@1.2.0"
      ],
      "env": {
        "SENDMOCK_TOKEN": "your-sendmock-token-here",
        "SENDMOCK_SERVER": "your-sendmock-server-here",
        "SENDMOCK_MCP_TOOLSETS": "your-sendmock-mcp-toolsets-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

SendMock

CI Release npm crates.io Downloads npm downloads crates.io downloads Docker pulls GHCR License: MIT OR Apache-2.0 Docs Live demo

SendMock is a local stand-in for the email, SMS, push and payment services your app talks to, and for the webhooks they send back. It is one small program you run on your machine, in Docker or in CI.

Webhook simulation built in: fire a delivered, bounced, opened, inbound reply or payment succeeded webhook whenever you need one, signed the way the real provider signs it, straight to your app on localhost. You test your webhook handlers without a tunnel, a public URL or a provider sandbox.

The problem: while you build and test an app, it sends real things. A sign-up test emails a real address, an OTP test texts a real phone and costs money, a checkout test needs a payment sandbox, and the webhooks those services send back are hard to trigger on demand. Teams end up with shared test inboxes, borrowed phones, provider sandboxes and flaky tests.

What SendMock does: your app sends to SendMock instead, over SMTP or the same HTTP APIs it already uses for Twilio, SendGrid, Stripe, FCM and others (only the address changes). SendMock keeps every message, shows it in a web UI, pulls out codes and links for your tests, and sends realistic webhooks back to your app. Nothing reaches a real inbox, phone or payment provider, and it costs nothing.

Documentation: https://shibbirweb.github.io/sendmock/docs/

Live demo: https://shibbirweb.github.io/sendmock/demo/

Website: https://shibbirweb.github.io/sendmock/

The SendMock overview: latest emails and SMS, webhook deliveries and payments

How it works

Your app sends to SendMock instead of the real provider:

%%{init: {"flowchart": {"curve": "basis"}}}%%
flowchart LR
    App["Your app"] -->|"email, SMS, push, payments"| SendMock["SendMock"]
    SendMock -.->|"the provider's answer and webhooks"| App
    SendMock -->|"web UI and API"| You["You and your tests"]

No message reaches a real inbox, phone or provider unless you set up a real relay and allow the recipient.

Watch the video: SendMock: Test Email, SMS and Payment Webhooks on Localhost

Play the video: SendMock: Test Email, SMS and Payment Webhooks on Localhost (2:01, on YouTube)

What it catches

  • Email over SMTP (and POP3 to read it back), with HTML, text and source previews, link and spam checks, one-time code extraction, and a Mailpit-compatible API.
  • SMS and verification codes through the APIs of Twilio, Vonage and other providers, with conversation threads and replies.
  • Push notifications sent through FCM, Expo and OneSignal.
  • Payments through Stripe, PayPal, Razorpay, Paddle, bKash, SSLCommerz and your own gateways, with checkout pages and simulated outcomes.
  • Webhooks sent back to your app, in Standard Webhooks or each provider's own format, with rules, templates and delivery logs.
  • Any HTTP request sent to a catcher bin, with mock responses.

Everything works from the web UI, the REST API, the sendmock CLI and an MCP server for AI agents.

Install

SystemCommand
macOS, Linux (Homebrew)brew install shibbirweb/tap/sendmock
macOS, Linux (script)curl -fsSL https://github.com/shibbirweb/sendmock/releases/latest/download/install.sh | sh
Windows (PowerShell)irm https://github.com/shibbirweb/sendmock/releases/latest/download/install.ps1 | iex
Windows (Scoop)scoop bucket add shibbirweb https://github.com/shibbirweb/scoop-bucket, then scoop install shibbirweb/sendmock
Any system with Node.jsnpx sendmock (no install)
Any system with Bunbunx sendmock (no install)
Dockerdocker run --rm -p 1025:1025 -p 8025:8025 ghcr.io/shibbirweb/sendmock

WinGet, Chocolatey, apt, dnf, Nix, Cargo, the beta of each channel, plain binaries, a Helm chart, a Docker Desktop extension and a menu bar app are on the install page.

Quick start

  1. Start SendMock:

    sendmock
    
  2. Open the web UI at http://127.0.0.1:8025.

  3. Point your app's SMTP settings at host 127.0.0.1, port 1025. Connect your app has the settings for PHP, Node.js, Python, Go, Java, Rust, Ruby and .NET.

SendMock listens on 127.0.0.1 only, so nothing outside your machine can reach it. sendmock --demo starts it with sample data to look around, sendmock --help lists the flags, and sendmock help --all every command.

Send your first message

Everything your app sends shows up in the web UI at once. The examples below are in JavaScript (Node.js); any language works the same way, since SendMock speaks plain SMTP and HTTP.

Email over SMTP

Use these settings in your app or mail library. No password or TLS is needed:

SettingValue
Host127.0.0.1
Port1025
Username and passwordnone (any are accepted)
Encryptionnone

For example, with Nodemailer:

import nodemailer from "nodemailer";

const transporter = nodemailer.createTransport({
  host: "127.0.0.1",
  port: 1025,
  secure: false,
});

await transporter.sendMail({
  from: "app@example.com",
  to: "user@example.com",
  subject: "Welcome",
  html: "<p>Your code is <b>482913</b></p>",
});

Connect your app has the same settings for PHP, Python, Go, Java, Rust, Ruby and .NET.

Email and SMS over the REST API

This example uses fetch in JavaScript or TypeScript. From any other language, send the same JSON in an HTTP POST request.

Send an email:

await fetch("http://127.0.0.1:8025/api/v1/send", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "app@example.com",
    to: ["user@example.com"],
    subject: "Welcome",
    html: "<p>Your code is <b>482913</b></p>",
  }),
});

Send an SMS:

await fetch("http://127.0.0.1:8025/api/v1/sms", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    from: "+15550001111",
    to: "+15550002222",
    body: "Your code is 482913",
  }),
});

Through your provider's SDK

Keep your Twilio, Vonage, SendGrid, Mailgun, Postmark, Resend, SES, Stripe, FCM or Expo code and change its base URL to http://127.0.0.1:8025/providers/<provider>, for example http://127.0.0.1:8025/providers/twilio.

Learn more

Use it from an AI agent

SendMock ships an MCP server and a skill, so an agent in Claude Code, Codex, Cursor, Gemini CLI or VS Code can read the codes your app sent, set up webhooks and check what happened:

sendmock ai install --target claude-code

Use SendMock from AI agents covers each agent.

Run it from source

You need Rust and Bun.

  1. Build the web UI:

    cd web
    
    bun install --frozen-lockfile
    
    bun run build
    
  2. Start SendMock from the repository root:

    cd ..
    
    cargo run -p sendmock
    
  3. Open http://127.0.0.1:8025.

Contributing

Read CONTRIBUTING.md to set up and make a change, and AGENTS.md for the rules every change follows. Report security problems privately as described in SECURITY.md.

License

SendMock is licensed under either of

at your option.

Reviews

No reviews yet

Be the first to review this server!