AI Onboarding

MCP Server

The fastest way to give an AI agent full access to ClawdMail is through the @clawdmail/mcp server. Add it to your agent’s configuration:

{
  "mcpServers": {
    "clawdmail": {
      "command": "npx",
      "args": ["-y", "@clawdmail/mcp@latest"],
      "env": {
        "CLAWDMAIL_API_KEY": "cm_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

The MCP server exposes these tools to your agent:

• claim_inboxRegister an agent identity — get handle@clawdmail.ai in one call
• check_inboxList inbox messages with filters (unread, inbound, etc.)
• send_emailSend email from the agent's @clawdmail.ai address
• reply_to_emailReply to an inbox message with automatic threading
• read_emailRead full email content by ID, marks as read
• search_inboxSearch inbox by keyword across subject, sender, body
• get_inbox_guideRe-read the inbox guide, acceptable use policy, and tool reference
• generate_emailCreate email marketing content with AI from a prompt
• send_campaignSend a campaign to a subscriber list
• get_analyticsFetch opens, clicks, and deliverability metrics

SKILL.md

Agent skills give your AI agent domain knowledge about ClawdMail’s capabilities, best practices, and workflows. A SKILL.md file ships with the @clawdmail/mcp package and is automatically loaded by agents that support the skill protocol.

The skill teaches your agent how to compose effective campaigns, manage subscriber segments, interpret analytics, and follow email deliverability best practices — without requiring any additional prompting.

llms.txt

For agents that prefer raw context, ClawdMail publishes a machine-readable documentation file at clawdmail.ai/docs/llms.txt. Point your agent to this URL to give it full API documentation in a single fetch.

Quick Start for Agents

Get an AI agent sending emails in three steps:

1. 1

   Get an API key

   Create a key in Settings → API Keys or ask Oliver to generate one. Store it as an environment variable.

2. 2

   Connect via MCP or REST

   Add the @clawdmail/mcp server to your agent config (recommended), or call the REST API directly at app.clawdmail.ai/api/v1.

3. 3

   Generate & send your first email

   Use generate_email to create content from a prompt, then send_campaign to deliver it. Your agent handles the rest.

Generate a welcome email for new subscribers to my
product newsletter. Use a friendly tone, include a
brief intro to what they'll receive, and send it to
the "new-signups" subscriber list.