Email and campaigns
Connect an AI (MCP)
Let Claude, ChatGPT or Claude Code send email, add contacts, run campaigns and plan follow-up calls for your account, safely.
YoMail has an MCP server. Once you connect it, an AI assistant can work in your account: send an email, add contacts, write and schedule a campaign, read the report and plan a follow-up call. It can only do what your account is allowed to do, and the same plan limits, unsubscribe rules and consent rules apply.
The address is always https://mcp.meghlycloud.com/mcp.
Claude (claude.ai and Claude Desktop) and ChatGPT
- Open the app's settings and add a custom connector.
- Paste the address above. Leave everything else empty.
- The app opens a YoMail sign-in. Sign in and read the list of what it asks for.
- Press Allow.
The AI acts as you, never with more than your role allows. A read-only user cannot let an app send mail. You can disconnect any time from your account.
validate_email uses a Validate API key. If you want that tool, use the API-key way below, or ask the AI to use another tool.
Claude Code and other tools that take headers
- Open API keys and make a key just for the AI.
- Give it only the scopes the AI needs.
- Add the server with the header
Authorization: Bearer <your key>.
For Claude Code, run this on your computer (replace the key):
claude mcp add --transport http yomail https://mcp.meghlycloud.com/mcp --header "Authorization: Bearer ym_live_..."| You want the AI to | Scope |
|---|---|
| send single emails | SendMail |
| see and add contacts | ManageContacts |
| create, schedule and read campaigns | ManageCampaigns (ReadCampaigns for reports only) |
A key can do everything its scopes allow. Never paste a key into a chat. Delete the key if you stop using it.
What the AI can do
| Tool | What it does |
|---|---|
send_email | Send one email from a verified domain. testMode checks without sending. |
validate_email | Check if an address can receive mail. |
list_contact_lists | Your lists and their ids. |
add_contacts | Add up to 100 contacts per call. |
list_campaigns | Campaigns with status and counts. |
create_campaign | Make a draft. Nothing is sent. |
schedule_campaign | Send now or later. |
campaign_report | Results of a campaign. |
voice_status | Is MeghlyVoice connected to your account. |
set_contact_phone | Save a phone number on a contact. |
set_followup_call | On a draft, call people who did not open (or click) after N days. |
campaign_calls | Results of the follow-up calls. |
cancel_followup_call | Cancel a follow-up call that has not started. |
Safety rules
- Big sends need your yes. A campaign to more than 1,000 contacts, or one email to more than 10 addresses, does not go until the AI asks you and calls again with confirmation.
- Calls need consent. A person is only called if call consent is recorded with a source. The AI must not guess consent: tell it only about people who really agreed.
- Rate limit. 60 tool calls per key per minute.
- Audit. Each call is logged with the tool name and a short fingerprint of the key. Message text and phone numbers are not logged.
- Voice key stays in the dashboard. Connecting MeghlyVoice is done on the Voice calls page, never in chat.
Try it
Ask: "List my contact lists." Then: "Make a draft campaign for the Customers list with subject ... and show me the audience size before scheduling." Check the draft in the dashboard before you say yes to sending.
If it does not work
| You see | Do this |
|---|---|
| "No API key" | Add the Authorization header, or connect with sign-in. |
| "forbidden" / missing scope | Add the scope to the key, or ask an admin to change your role. |
| "Nothing was sent" and a number | The send is large. Say yes to the AI, and it will confirm. |
| Too many requests | Wait a minute. |