MailValid MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with MailValid MCP or direct API to verify email addresses, run bulk checks, track verification jobs, and review delivery feedback through natural language.

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

Try MailValid now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
MailValid
Try asking
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.

SETUP GUIDE

Connect MailValid MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["mailvalid"],
  mcp: true,
});
Create a session scoped to MailValid and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Verify the email address test@example.com and report its validation result.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a MailValid request
SETUP GUIDE

Connect MailValid API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["mailvalid"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to MailValid
3

Run MailValid tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Verify the email address test@example.com and report its validation result." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the MailValid tool calls through the session, and print the final answer

Why Use Composio?

AI Native MailValid Integration

  • Supports both MailValid MCP and direct API integrations
  • Structured, LLM-friendly schemas for reliable email verification and job tracking
  • Rich coverage for individual checks, bulk validation, credits, and delivery feedback

Managed Auth

  • Securely stores and applies your MailValid API key to tool requests
  • Central place to manage, scope, and revoke MailValid access
  • Per-user and per-environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve verification reliability over time
  • Clear responses help agents interpret validation results, job status, credit usage, and feedback
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access MailValid
  • Scoped, least-privilege access to verification and reporting operations
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
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