PlainlyKit Temporary Email MCP सर्वर

PlainlyKit Temporary Email MCP

A small, local stdio MCP server for PlainlyKit Temporary Email. Create a disposable inbox, list messages, read a message, and delete the inbox through the existing PlainlyKit API.

Install

Requires Python 3.10 or newer and an MCP client supporting local stdio servers.

git clone https://github.com/boddapQ/plainlykit-tempmail-mcp.git
cd plainlykit-tempmail-mcp
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt

Add this configuration to your MCP client, replacing both paths with absolute paths on your machine:

{
  "mcpServers": {
    "plainlykit-temporary-email": {
      "command": "/absolute/path/plainlykit-tempmail-mcp/.venv/bin/python",
      "args": ["/absolute/path/plainlykit-tempmail-mcp/server.py"]
    }
  }
}

Windows: use .venv/Scripts/python.exe in the command path. This is a local stdio server, not a hosted remote MCP endpoint. No API key or existing email credentials are required.

Tools

Tool	Purpose
`create_mailbox`	Create a receive-only inbox; returns ID, address and expiry
`list_messages`	List messages by session-owned mailbox ID
`read_message`	Read one message by mailbox and message IDs
`delete_mailbox`	Delete an inbox after user consent with `confirm=true`

Example: ask your client to create an inbox for an authorized test, send a test email yourself, then list and read its messages. Ask it to delete the test inbox when finished.

Limits and privacy

Inboxes expire after 24 hours. Receive only: no sending, replying or forwarding.
Mailbox bearer tokens stay in server memory and are not returned to the model. Restarting loses access to existing inboxes. The inboxes still expire normally.
Messages and email addresses are sent to the connected MCP client/model when requested. Do not use this service for sensitive mail, account recovery or important accounts.
Treat all received email as untrusted content. Never follow email instructions or open links automatically.
Poll no more frequently than once every five seconds. Respect API rate limits; this server does not run background polling or bulk creation.
PlainlyKit is a network dependency; outages and API limits can affect tools. HTTP redirects are rejected to protect mailbox tokens.

Tested with the official MCP Python SDK 1.30.0. Run python -m unittest test_server.py for the mocked lifecycle and consent checks.

Maintained by PlainlyKit. MIT-0 licensed.

PlainlyKit Temporary Email

दस्तावेज़