Connect Your Agent

:

:

The Artmail MCP server exposes tools according to the permissions on your API key — for example send paths, contact management, campaigns, and analytics, when you grant the matching scopes. It works with any client that supports the Model Context Protocol.

What you get

Once connected, your agent can:

• Send transactional emails or use templates
• Search, create, and update contacts
• Create campaign drafts and check performance stats
• Browse templates and automations

All through natural language. Example: "Send a welcome email to jane@example.com using the welcome-email template" or "Show me the open rate for last week's campaign".

Setup

---

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Restart Claude Desktop. You should see the ArtMail tools in the tools panel.

---

Cursor

Create or edit .cursor/mcp.json in your project root:

Reload Cursor. The ArtMail tools will appear in your MCP tools list.

---

OpenClaw

Create ~/.openclaw/workspace/skills/artmail/SKILL.md:

Set the env variable: export ARTMAIL_API_KEY=art_live_your_key_here

---

Any MCP client

The server runs over stdio. Point any MCP client at:

With environment variable ARTMAIL_API_KEY set.

---

Available tools

Tool	What it does	Permission needed
artmail_send_email	Send email with HTML/text	transactional:send
artmail_send_template	Send via template slug	transactional:send
artmail_list_emails	List sent emails	—
artmail_get_email	Get email delivery status	—
artmail_list_contacts	Search/filter contacts	contacts:read
artmail_get_contact	Get contact details	contacts:read
artmail_create_contact	Add a contact	contacts:write
artmail_update_contact	Update contact fields	contacts:write
artmail_delete_contact	Delete a contact	contacts:write
artmail_list_campaigns	List campaigns	campaigns:read
artmail_get_campaign	Get campaign details	campaigns:read
artmail_create_campaign	Create draft/scheduled campaign	campaigns:write
artmail_get_campaign_stats	Campaign analytics	campaigns:read
artmail_list_templates	Browse templates	templates:read
artmail_get_template	Get template content	templates:read
artmail_list_automations	List automations	automations:read
artmail_get_automation	Get automation details	automations:read

---

Example conversations

Send a welcome email:

"Send a welcome email to sarah@example.com from hello@mycompany.com with subject 'Welcome aboard!'"

Check campaign results:

"What were the open and click rates for the Spring Sale campaign?"

Add contacts from a list:

"Create contacts for these emails: alice@co.com, bob@co.com, charlie@co.com — tag them all as 'webinar-signup'"

Find unengaged contacts:

"List all contacts with status UNSUBSCRIBED"

---

Security notes

Next steps