Sentfromai MCP

What Sentfromai MCP MCP server does

Sentfromai MCP MCP server connects MCP-compatible agents to SentFromAI, an email infrastructure service for AI agents. It exposes operations for inbox management, messages, threads, drafts, domains, webhooks, and allow/block address rules. The package provides 21 tools, each corresponding to an operation in the SentFromAI REST API.

The server supports both local MCP execution and a hosted remote endpoint. In local mode, an MCP host launches the package with npx. The hosted option is available at https://api.sentfrom.ai/mcp for clients that support Streamable HTTP.

How it works

Each tool call results in an HTTPS request to the SentFromAI API. Authentication uses an API key, supplied through the local server environment or as a bearer token or x-api-key header for the hosted endpoint. The server does not keep local state or store data on disk.

Tool annotations identify read, write, send, and delete operations. This lets MCP hosts distinguish potentially irreversible actions, such as sending a message or deleting an inbox. API errors are returned as tool results with an error flag and HTTP status, allowing an agent to identify issues such as an invalid key or a plan limit.

Sentfromai MCP MCP server also preserves email behavior supplied by the API. Replies include the appropriate threading headers, and sending follows the API's idempotency and suppression rules. Message search offers keyword, semantic, and hybrid modes.

Setup and configuration

A SentFromAI API key beginning with sf_live_ is required. Obtain it from the SentFromAI console, then configure the local server with SENTFROMAI_API_KEY. SENTFROMAI_BASE_URL is optional and defaults to https://api.sentfrom.ai.

For a JSON-based MCP host, configure a server that runs npx -y sentfromai-mcp and passes the API key in its environment. Claude Code and Codex can add the same command through their MCP command-line configuration. Gemini CLI installs the extension from the project repository, while supported remote clients can connect to the hosted endpoint with authentication.

The package also exports createServer, TOOLS, callTool, and createApi for embedding the tools in a custom MCP host or transport.

Tools and capabilities

Available operations include:

• Create, list, and delete inboxes.
• Send, reply to, forward, read, and search messages.
• List and retrieve threads.
• Create, send, and list drafts.
• Add and inspect custom domains.
• Create, list, and delete webhooks.
• Add, list, and delete address allow/block rules.

The same tool set is available through the hosted Streamable HTTP endpoint. Sentfromai MCP MCP server is therefore suitable for agents that need either local stdio-style execution or a remote MCP connection.

Limitations and notes

The server depends on SentFromAI account access and API availability; it is not an independent mail provider. Usage is subject to the account's plan limits. The README documents a free plan with five inboxes and 5,000 emails per month.

Sending and deletion operations can have external effects, so hosts may request confirmation based on the tools' annotations. The server itself does not retain local state. Privacy, terms, and email data handling are governed by SentFromAI's policies and service behavior.