How to Use the Mailsac MCP in Claude Code

Q: How do I run a Mailsac email check inside Claude Code?

You ask the CLI agent to check a specific inbox. It calls listinboxmessages to pull the latest emails and then uses getplaintextbody to output the text directly to your terminal.

Q: How do I register the Mailsac MCP Server in Claude Code?

Run the command claude mcp add --transport http mailsac-mcp -- in your terminal. This registers the MCP Server in your local configuration file so the CLI agent can use the email tools instantly.

Pipe Mailsac email payloads directly into your terminal workflows and CI/CD pipelines using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailsac MCP to Claude Code

Create your Vinkius account to connect Mailsac to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mailsac with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Email Testing in Claude Code

Run your email verification checks directly from your terminal or shell scripts. This command-line setup lets you query incoming test emails and pipe the raw text directly into other CLI utilities without a browser. The agent uses `list_inbox_messages` to fetch the message queue and reads the content with `get_plain_text_body`. You can easily script this to verify login codes or API keys during automated deployment checks.

Programmatic Address Reservation

Manage your testing infrastructure from the command line without clicking through a web dashboard. You can provision, inspect, and tear down temporary and permanent test mailboxes on the fly. Your agent calls `reserve_new_address` to claim a specific mailbox for your test run. Once the automated checks are complete, it runs `release_reserved_address` to free up the resource and keep your account clean.

Global Message Searching via this MCP Server

Find test messages across your entire account using rapid command-line searches. This MCP Server allows your CLI agent to query all your custom domains and inboxes simultaneously. The agent invokes `search_account_messages` with search parameters like sender or subject line. It can also fetch your custom domains using `list_custom_domains` to verify where the mail was routed.

Setup guide

Set up Mailsac MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see mailsac-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Mailsac transactions." It will automatically discover and invoke the available Mailsac tools.

Terminal

claude mcp add --transport http mailsac-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Mailsac MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "mailsac-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mailsac. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mailsac now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mailsac MCP in Claude Code

You ask the CLI agent to check a specific inbox. It calls `list_inbox_messages` to pull the latest emails and then uses `get_plain_text_body` to output the text directly to your terminal.

Yes, you can command the agent to clean up after a test. It calls `delete_inbox_message` to permanently remove specific emails from your testing inbox, keeping your storage usage low.

Run the command `claude mcp add --transport http mailsac-mcp -- ` in your terminal. This registers the MCP Server in your local configuration file so the CLI agent can use the email tools instantly.

Yes, if your account tier supports it, the agent can search your entire history. It calls `search_account_messages` to find specific emails across all your configured addresses.

Your email messages and custom domains are processed entirely within a local, sandboxed environment. No external logs are kept, and your API credentials never leave your local config file, securing your data from external leaks.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript