mailpit_mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAILPIT_URL | No | Mailpit HTTP API base URL | http://127.0.0.1:8025 |
| MAILPIT_AUTH_PASS | No | Basic auth password | |
| MAILPIT_AUTH_USER | No | Basic auth username (if enabled on Mailpit) | |
| MAILPIT_TIMEOUT_MS | No | HTTP request timeout | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mailpit_healthA | Check Mailpit server health via GET /api/v1/info |
| mailpit_list_messagesB | List recent captured messages (newest first) |
| mailpit_searchA | Search messages using Mailpit query syntax (e.g. to:user@example.test subject:welcome) |
| mailpit_get_messageA | Get full message content by ID (or "latest") |
| mailpit_get_latest_for_recipientB | Get the most recent message sent to a recipient email address |
| mailpit_wait_for_messageB | Poll Mailpit until a matching message arrives or timeout |
| mailpit_extract_otpA | Extract a numeric verification code from message plain text or HTML |
| mailpit_delete_allA | Delete all messages in the Mailpit mailbox (test reset) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: delete all, extract OTP, get latest for recipient, get by ID, health check, list, search, and wait. No overlap or ambiguity.
All tools start with 'mailpit_' and most follow a verb_noun pattern (e.g., mailpit_delete_all, mailpit_list_messages). However, 'mailpit_health' is a noun only and 'mailpit_search' is a verb without a noun, causing slight inconsistency.
8 tools is well-scoped for an email testing server. Each tool serves a necessary function without being excessive or insufficient.
The tool set covers all essential operations for Mailpit: health check, listing, retrieving, searching, waiting, extracting OTPs, and resetting the mailbox. No obvious gaps for the intended domain.