AI & agents

Agent skill

A drop-in Agent Skill that teaches your AI agent to run MailKite end-to-end — create an account, add a domain, set its DNS at the user's provider, register a webhook, design templates, send, and confirm inbound delivery. It works over the MCP server, the CLI, any SDK, or raw REST.

MailKite skill

SKILL.md + reference bundle · MIT · ~20 KB

Download .zip View source

Install in Claude Code

Unzip into your skills directory — user-wide (~/.claude/skills/) or per-project (.claude/skills/). Claude Code discovers it automatically on the next run.

bash

# Download and install for Claude Code (user-wide)
curl -L https://mailkite.dev/skill/mailkite.zip -o mailkite.zip
unzip mailkite.zip -d ~/.claude/skills/

# …or scope it to one project
unzip mailkite.zip -d .claude/skills/

Install in claude.ai or Claude Desktop

Go to Settings → Capabilities → Skills, choose Upload skill, and drop in the mailkite.zip you downloaded. That's it — ask Claude to "set up MailKite email for my domain" and the skill takes over.

What's inside

File	What it covers
`SKILL.md`	The end-to-end playbook: account → domain → DNS → webhook → send → confirm.
`reference/access-methods.md`	MCP vs CLI vs SDK vs REST — when to use each, with config.
`reference/dns-providers.md`	Apply DNS on Cloudflare, GoDaddy, Namecheap, Route 53, or by hand.
`reference/webhooks.md`	Inbound payload shape and signature verification.
`reference/templates.md`	Template model, CRUD, and sending a design test.
`reference/api.md`	Every endpoint, auth, and request/response shape.

Pairs with the CLI & MCP server

The skill drives MailKite through whichever access method is available. For an agent with a terminal, the CLI is the most reliable path:

bash

npx @mailkite/cli login --email you@example.com --password ••••• --json
npx @mailkite/cli init --domain mail.myapp.ai --provider cloudflare \
  --webhook https://myapp.ai/hooks/mailkite --to you@example.com --verify --json

For an MCP client, point it at the MailKite server:

mcp.json

{
  "mcpServers": {
    "mailkite": {
      "command": "npx",
      "args": ["-y", "@mailkite/mcp"],
      "env": { "MAILKITE_API_KEY": "mk_live_…" }
    }
  }
}

Both hit the same API and the same contract as every SDK. See Agent inboxes & MCP for the bigger picture.