README.md•1.85 kB
# 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