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

  1. Open the app's settings and add a custom connector.
  2. Paste the address above. Leave everything else empty.
  3. The app opens a YoMail sign-in. Sign in and read the list of what it asks for.
  4. 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

  1. Open API keys and make a key just for the AI.
  2. Give it only the scopes the AI needs.
  3. Add the server with the header Authorization: Bearer <your key>.

For Claude Code, run this on your computer (replace the key):

bash
claude mcp add --transport http yomail https://mcp.meghlycloud.com/mcp --header "Authorization: Bearer ym_live_..."
You want the AI toScope
send single emailsSendMail
see and add contactsManageContacts
create, schedule and read campaignsManageCampaigns (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

ToolWhat it does
send_emailSend one email from a verified domain. testMode checks without sending.
validate_emailCheck if an address can receive mail.
list_contact_listsYour lists and their ids.
add_contactsAdd up to 100 contacts per call.
list_campaignsCampaigns with status and counts.
create_campaignMake a draft. Nothing is sent.
schedule_campaignSend now or later.
campaign_reportResults of a campaign.
voice_statusIs MeghlyVoice connected to your account.
set_contact_phoneSave a phone number on a contact.
set_followup_callOn a draft, call people who did not open (or click) after N days.
campaign_callsResults of the follow-up calls.
cancel_followup_callCancel 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 seeDo this
"No API key"Add the Authorization header, or connect with sign-in.
"forbidden" / missing scopeAdd the scope to the key, or ask an admin to change your role.
"Nothing was sent" and a numberThe send is large. Say yes to the AI, and it will confirm.
Too many requestsWait a minute.

Stuck?

Talk to our engineers directly — by phone or email.

01782618248shohag.meghly@gmail.com