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:

{
  "name": "create_inbox",
  "arguments": {
    "domain": "example.com"
  }
}

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:

{
  "name": "send_email",
  "arguments": {
    "inboxId": "inbox_123",
    "to": "recipient@example.com",
    "subject": "Hello from AgentMail!",
    "text": "This is a test email sent via the MCP server."
  }
}

Running the Server

npm run dev

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