otherapi_key

Mails.so

Mails is an API service that provides powerful email validation capabilities to help maintain a clean and effective email list.

Verdict

Mails.so validates email addresses before you send to them — checking deliverability, detecting disposable domains, and flagging risky addresses. In Switchy, @mention it to verify single emails on the fly or submit bulk lists for batch validation. Marketing and sales teams use it to clean contact lists before campaigns; support teams use it to catch typos in user-submitted addresses. The MCP exposes three tools: single validation for quick checks, bulk validation for lists, and batch result retrieval once a job completes. You'll need an API key from Mails.so; no OAuth flow. Rate limits depend on your plan tier.

Common use cases

  • Clean email lists before campaign sends
  • Verify user signups in real time
  • Flag disposable addresses during onboarding
  • Audit CRM contacts for deliverability
  • Check typos in support ticket replies

Integration

Vendor
Mails.so
Category
other
Auth
API_KEY
Tools
3
Composio slug
mails_so

Tools

  • Retrieve Batch Results

    Tool to retrieve results of a bulk validation job. use after submitting a batch and you have its id.

  • Validate Bulk Emails

    Tool to validate multiple email addresses in bulk. use when you need to confirm deliverability of a list of emails at once.

  • Validate Single Email

    Tool to validate a single email address. use when you need to check deliverability and quality details before sending an email.

Setup

Setup guide

  1. 11. Log into your Mails.so account and navigate to the API settings page to generate a new API key. 2. In Switchy, open your workspace settings and click 'Integrations' then 'Add MCP'. 3. Search for 'Mails.so' and select it from the list. 4. Paste your API key into the authentication field and click 'Connect'. 5. Switchy will test the connection by pinging the Mails.so API; you'll see a green checkmark if it succeeds. 6. Open any Space, type '@Mails.so validate the email john@example.com' and send the message. 7. The MCP will return deliverability status, domain health, and whether the address is disposable or a catch-all. 8. For bulk jobs, upload a CSV or paste a list in your prompt; the MCP will submit the batch and give you a job ID to retrieve results later.

What teammates see: by default, memories from Mails.so are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Validate Single Address

@Mails.so validate the email address sarah.jones@acmecorp.com and tell me if it's safe to send to.
Open in a Space →

Bulk List Validation

@Mails.so validate this list of emails in bulk: alice@example.com, bob@test.io, charlie@disposable.net. Give me the batch ID when it's queued.
Open in a Space →

Retrieve Batch Results

@Mails.so retrieve the results for batch job ID abc123xyz and summarize how many emails passed, failed, or are risky.
Open in a Space →

Check Disposable Domains

@Mails.so check if the domain in user@tempmail.org is disposable and explain why it matters for our signup flow.
Open in a Space →

Audit CRM Export

@Mails.so validate the emails in this CSV I just exported from HubSpot and flag any that are catch-alls or have syntax errors.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Mails.so validate the email address john.doe@example-corp.com before I add it to our outreach campaign

Output

Validation complete for john.doe@example-corp.com. Status: Valid. The email address is deliverable with a quality score of 92/100. MX records are configured correctly, the domain is active, and no disposable email pattern was detected. SMTP verification confirms the mailbox exists. Safe to include in your outreach list.

Notes

Single email validation is ideal for real-time checks during form submissions or manual list curation. Each validation consumes one credit from your account balance. The quality score reflects deliverability confidence but cannot guarantee inbox placement or user engagement.

Prompt

@Mails.so I have a CSV with 450 email addresses from our conference signup sheet. Validate them in bulk and flag any that won't deliver.

Output

Bulk validation job submitted successfully. Job ID: batch_7k3m9p2x. Processing 450 email addresses. Estimated completion: 3-5 minutes depending on current queue load. Use the job ID to retrieve results once processing finishes. You'll receive a breakdown of valid, invalid, risky, and unknown addresses with detailed reasons for each classification.

Notes

Bulk validation is asynchronous — you submit the list, then poll for results using the batch ID. This example shows the submission step; a follow-up prompt would retrieve the completed results. Bulk jobs are more credit-efficient than validating individually but require waiting for processing to complete.

Prompt

@Mails.so retrieve results for batch job batch_7k3m9p2x and summarize how many emails are safe to use versus risky or invalid

Output

Batch results retrieved. Out of 450 emails: 387 valid (86%), 41 invalid (9%), 18 risky (4%), 4 unknown (1%). Invalid addresses include syntax errors and non-existent domains. Risky addresses are role-based (info@, support@) or disposable providers. Unknown results indicate temporary DNS issues during validation. Recommend using only the 387 valid addresses for your campaign to maintain sender reputation.

Notes

This example pairs the MCP's data retrieval with the AI's ability to synthesize actionable advice. The batch must be fully processed before results are available — polling too early returns a 'still processing' status. Results include granular reasons for each classification, useful for cleaning your contact database.

Use-case deep-dives

Cold outreach list hygiene

When Mails.so saves your sender reputation before a campaign

A 3-person growth team scraping 800 leads from LinkedIn for a cold email sequence needs to validate deliverability before hitting send. Mails.so's bulk validation tool catches catch-all domains, role addresses, and disposable inboxes in one batch job—preventing the bounce rate spike that tanks sender reputation. The team submits the list, retrieves results an hour later, and filters out 140 risky addresses before importing to their ESP. This works when your list is under 5,000 contacts and you're running campaigns weekly or monthly. If you're sending daily at scale or need real-time validation during a signup flow, you'll want a streaming integration instead. For pre-campaign hygiene at small-team velocity, Mails.so keeps your domain out of spam folders without engineering overhead.

Customer support ticket triage

Why single-email validation matters for support ticket routing

A 6-person support team gets 40 inbound tickets daily, half from free-tier users who typo their email during signup. Before escalating a ticket or sending a password reset, the team lead validates the sender address with Mails.so's single-email tool to confirm it's deliverable. This catches the user who wrote 'gmial.com' or the throwaway address that bounced three times last month. The validation runs in 2 seconds, surfaces syntax errors and mailbox status, and prevents wasted back-and-forth on dead threads. This is overkill if your support volume is under 10 tickets a week or your CRM already dedupes contacts. For teams triaging dozens of tickets daily without a validation layer in their stack, Mails.so's single-check tool closes the loop before you waste 15 minutes drafting a reply to a fake address.

Event registration data cleanup

When batch validation rescues a webinar attendee list

A 2-person marketing team runs a monthly webinar and collects 300 registrations through a Typeform that doesn't enforce email syntax. Two days before the event, they export the list and run Mails.so's bulk validation to catch typos, spam traps, and inactive accounts. The batch job flags 35 invalid addresses and 12 disposables, letting the team send reminder emails only to real attendees. This prevents the webinar platform from throttling their sends due to bounce complaints. The workflow breaks down if you're running daily events or need sub-hour turnaround—batch results take 30-90 minutes depending on list size. For monthly or quarterly events where you control the send schedule, Mails.so's batch tool cleans your list without adding a validation step to your registration form.

Frequently asked

What does the Mails.so MCP do in Switchy?

It validates email addresses before you send campaigns or import contact lists. The MCP checks deliverability, flags disposable addresses, and catches syntax errors. You can validate single emails on the fly or submit bulk jobs for entire lists. Results include a quality score and risk flags so you can clean your data before it hits your ESP.

Do I need a Mails.so account to use this MCP?

Yes. You need an active Mails.so account and an API key from their dashboard. Paste the key into Switchy's connection flow and the MCP authenticates automatically. Your validation quota depends on your Mails.so plan—Switchy doesn't impose separate limits, but each validation call counts against your vendor balance.

Can the Mails.so MCP fix invalid email addresses?

No. It identifies problems—typos, fake domains, role addresses, disposable providers—but it doesn't rewrite or correct them. If an email fails validation, you'll see the reason code and need to manually update the address or remove it from your list. Think of it as a filter, not an autocorrect tool.

How is this different from validating emails in my ESP?

Most ESPs validate on send, which means bounces still hit your sender reputation. Mails.so runs checks before emails leave Switchy, so you catch issues upstream. You also get richer metadata—disposable flags, role account detection, SMTP verification—that typical ESP validation skips. Use this when list hygiene matters more than speed.

Who on the team should connect the Mails.so MCP?

Whoever manages your email lists or runs campaigns. The API key grants full validation access, so treat it like a shared credential. If multiple people need to validate emails, one person connects it in Switchy and the whole workspace inherits the integration. Validation jobs are logged per user for audit trails.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.