# 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:
   ```bash
   npm install
   ```

2. Get your AgentMail API key from [https://agentmail.com](https://agentmail.com)

3. Update the `smithery.yaml` file with your API key:
   ```yaml
   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:**
```json
{
  "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:**
```json
{
  "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

```bash
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