AgentMail MCP Server

This is a Model Context Protocol (MCP) server that provides tools for creating email inboxes and sending emails using the AgentMail API.

Features

• Create Inbox: Create new email inboxes with optional domain specification

• Send Email: Send emails from any created inbox with support for both text and HTML content

Setup

1. Install dependencies:

   npm install

2. Get your AgentMail API key from https://agentmail.com

3. Update the smithery.yaml file with your API key:

   runtime: typescript config: agentmailApiKey: "your-actual-api-key-here"

Available Tools

create_inbox

Creates a new email inbox.

Parameters:

• domain (optional): Domain for the inbox

Example:

send_email

Sends an email from a specified inbox.

Parameters:

• inboxId: ID of the inbox to send from

• to: Recipient email address

• subject: Email subject

• text: Email body text

• html (optional): HTML version of the email

Example:

Running the Server

Error Handling

Both tools include comprehensive error handling and will return descriptive error messages if operations fail. Common issues include:

• Invalid API key

• Network connectivity problems

• Invalid inbox ID

• Malformed email addresses

Dependencies

• @modelcontextprotocol/sdk: MCP server implementation

• agentmail: AgentMail API client

• zod: Schema validation

• @smithery/cli: Development tools