sendmux-mcp 1.0.0

Curated MCP servers for the Sendmux API surfaces.

Sendmux MCP

Curated Model Context Protocol servers for the Sendmux mailbox, management, and sending API surfaces.

Install

pip install sendmux-mcp

For local development from this repository:

OPENAPI_INPUT_DIR=/path/to/sendmux-docs pnpm build:mcp

Run

Each surface is a separate server so credentials and tools stay isolated.

SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_root_... sendmux-mcp-sending

Use HTTP transport for hosted or remote clients. HTTP requires a separate MCP bearer token unless you explicitly opt out.

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

The MCP endpoint defaults to /mcp; /health returns a small JSON health response.

Configuration

Setting	Environment	Default
API key	SENDMUX_API_KEY	required
App API base URL	SENDMUX_APP_BASE_URL	https://app.sendmux.ai/api/v1
Sending API base URL	SENDMUX_SENDING_BASE_URL	https://smtp.sendmux.ai/api/v1
Transport	SENDMUX_MCP_TRANSPORT	stdio
HTTP host	SENDMUX_MCP_HOST	127.0.0.1
HTTP port	SENDMUX_MCP_PORT	8765
HTTP path	SENDMUX_MCP_PATH	/mcp
HTTP bearer token	SENDMUX_MCP_HTTP_BEARER_TOKEN	required for HTTP
Allowed browser origins	SENDMUX_MCP_ALLOWED_ORIGINS	no browser origins
Snapshot directory override	SENDMUX_MCP_OPENAPI_INPUT_DIR or OPENAPI_INPUT_DIR	packaged snapshots
App snapshot override	SENDMUX_MCP_APP_OPENAPI	packaged app snapshot
Sending snapshot override	SENDMUX_MCP_SENDING_OPENAPI	packaged sending snapshot

Packaged OpenAPI snapshots are the default so released tool names, schemas, and descriptions do not drift. Path, directory, and URL overrides are available for development, canary, and debugging runs.

Tool Surfaces

• Mailbox: message read/send, threads, folders, identity, and mailbox state tools. Requires an smx_mbx_ key.
• Management: domains, mailboxes, logs, metrics, and webhook tools. Requires an smx_root_ key.
• Sending: send and batch send tools. Requires an smx_root_ key.

The server rejects keys with the wrong prefix before starting.