How to integrate MailValid MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your MailValid account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

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

Also integrate MailValid with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating MailValid with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to MailValid

Ask your agent to connect to MailValid, or simply request any MailValid-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new MailValid connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to MailValid or request any MailValid-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the MailValid MCP server, 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.

Way Forward

With MailValid connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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