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

Install dependencies:
```
npm install
```
Get your AgentMail API key from https://agentmail.com

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

agentmail-mcp