How to connect MailValid to Claude

Connect Claude Web, Desktop and Cowork to MailValid MCP. Verify this customer email before sending, check bulk list for risky addresses, and more using natural language, with authentication handled for you.

MailValid logoMailValid
Api Key

MailValid is an email verification service for checking individual and bulk addresses. It helps teams reduce bounces and keep contact lists deliverable.

9 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your MailValid account to Claude via Composio Connect, enabling it to verify this customer email before sending, check bulk list for risky addresses, show your remaining MailValid verification credits, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate MailValid with

Connecting MailValid to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your MailValid account

Back in Claude, ask it to connect to MailValid or give it any MailValid-related task.

For example, ask Claude to:

  • "Verify this customer email before sending"
  • "Check bulk list for risky addresses"
  • "Show your remaining MailValid verification credits"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your MailValid account is ready to use.

What is the MailValid Claude Connector, and what's possible with it?

The MailValid MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your MailValid account. It provides structured and secure access to email verification, bulk verification jobs, credit balances, delivery feedback, and webhook signature checks, so your agent can verify addresses, manage bulk jobs, track credits, process delivery events, and validate webhook requests on your behalf.

  • Individual email verification: Have your agent check an email address for syntax, domain, MX, SMTP, disposable, role, catch-all, and provider details.
  • Bulk verification jobs: Direct your agent to start bulk email verification, monitor job progress, review available results, download completed results, or cancel pending work.
  • Credit and job tracking: Let the agent check your current MailValid credit balance, review lifetime usage, and list verification jobs by status.
  • Delivery feedback processing: Instruct your agent to submit bounce, complaint, unsubscribe, and other delivery events to update MailValid feedback records.
  • Webhook security checks: Have your agent verify MailValid completion webhook signatures against their original request body.

Troubleshooting

1. Why does Claude not use the Composio connector for MailValid?

The connector can show as connected, but Claude must use it in each MailValid conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to MailValid again.

2. Why does Claude show an MCP server error before MailValid connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for MailValid.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect MailValid.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the MailValid authorization link not work?

The Composio connector is one server. Your MailValid account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the MailValid connection.
  • Composio creates a fresh MailValid authorization link.
  • Open that link in your browser and finish the MailValid sign-in.

4. Why do MailValid actions fail after they worked before?

The MailValid connection can expire or lose permission.

  • Ask Claude to inspect the MailValid connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the MailValid account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in MailValid.
  • If the action still fails with a permission error, check that the connected account has that permission in MailValid itself.

5. How do I switch to a different MailValid account?

Claude can manage the MailValid connection for you.

  • Ask Claude to disconnect or delete the current MailValid account.
  • Ask Claude to connect MailValid again.
  • Open the new Composio authorization link for MailValid.
  • Sign in with the other MailValid account in the browser.
  • After the account connects, ask Claude to retry the MailValid task.

6. Why is my MailValid connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your MailValid connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If MailValid tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect MailValid.
TOOLS

Supported Tools

Every MailValid action and event your agent gets out of the box.

Cancel Bulk Job

DESTRUCTIVE: Cancel a pending or processing bulk verification job.

Create Bulk Verification

PAID / CREDIT-CONSUMING: Create an asynchronous verification job for many email addresses.

Download Bulk Results

Download a completed bulk job's results as JSON or CSV, optionally filtered by verification status.

Get Bulk Job

Get one bulk verification job's status, progress, metadata, and currently available inline results.

Get Credit Balance

Return the connected MailValid account's current credit balance and lifetime credit usage.

List Bulk Jobs

List one native page of bulk verification jobs, optionally filtered by status.

Submit Bounce Events

STATE-MUTATING: Submit real delivery, bounce, complaint, or unsubscribe feedback that can change MailValid reputation history, cached results, and future validity classifications.

Verify Email

PAID / CREDIT-CONSUMING: Verify one email using MailValid's syntax, domain, MX, SMTP, disposable, role, catch-all, and provider checks.

Verify Webhook Signature

Verify an X-Mailvalid-Signature HMAC-SHA256 header against the exact raw completion-webhook body.

FAQ

Frequently asked questions

Start with MailValid.It takes 30 seconds.

Managed auth, hosted MCP servers, and every MailValid tool your agent needs.Free to start.

Start building