MailOdds

Integrations

MCP Email Validation Server for AI Agents

190 email platform tools for AI agents. Connect Claude, Cursor, Windsurf, or any MCP client to the full MailOdds API surface through the Model Context Protocol.

MCP Server + MailOdds

190 email platform tools for AI agents. Connect Claude, Cursor, Windsurf, or any MCP client to the full MailOdds API surface through the Model Context Protocol.

Setup time: 5 min
Difficulty: Beginner
1,000 free validations included

Prerequisites

  • MailOdds account with API key
  • MCP-compatible client (Claude Desktop, Cursor, etc.)

Installation

Recommended

Method 1: npx

1

Get your API key from the dashboard.

2

Add this to your MCP client config file:

File: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

MCP Client Configuration

JSON
{
  "mcpServers": {
    "mailodds": {
      "command": "npx",
      "args": ["-y", "@mailodds/mcp-server"],
      "env": {
        "MAILODDS_API_KEY": "your_api_key_here"
      }
    }
  }
}
3

Verify installation

Restart your MCP client, then ask: Check my account health. You should see a health status response with your account details.

Method 2: Remote (no install)

Supported by Claude Code, Cursor, Windsurf, and VS Code. Claude Desktop requires Method 1 (npx).

1

Get your API key from the dashboard.

2

Add to your MCP client config. No local Node.js or Docker required:

Remote MCP Configuration

JSON
{
  "mcpServers": {
    "mailodds": {
      "url": "https://mcp.mailodds.com/sse",
      "headers": {
        "Authorization": "Bearer your_api_key_here"
      }
    }
  }
}

VS Code: use "servers" instead of "mcpServers" and add "type": "sse" to the server object.

3

Verify installation

Ask your agent: Check my account health. You should see a health status response with your account details.

190 Tools Across 29 Categories

Every tool maps to a MailOdds API endpoint. Your AI agent can call any of them.

Email Validation

7
validate_emailvalidate_batchcreate_bulk_jobget_job_statusget_job_resultscancel_joblist_jobs

Email Sending

2
safe_deliverbatch_deliver

Campaigns

8
create_campaignsend_campaignschedule_campaigncancel_campaignget_campaignlist_campaignscreate_campaign_variantget_ab_results

Subscriber Lists

8
create_subscriber_listlist_subscribersappend_contactsquery_contactsunsubscribeget_engagement_funnelget_engagement_trendsget_inactive_report

Deliverability

9
get_sender_healthget_sender_health_trendget_reputationget_reputation_timelineget_bounce_analysisget_bounce_recordscross_reference_bouncesanalyze_bouncesget_identity_score

DMARC

8
add_dmarc_domainget_dmarc_domainlist_dmarc_domainsverify_dmarc_domainget_dmarc_sourcesget_dmarc_trendget_dmarc_recommendationremediate_domain

Blacklist

4
check_blacklistadd_blacklist_monitorlist_blacklist_monitorsget_blacklist_history

Store Connections

7
connect_storedisconnect_storesync_storelist_storesget_store_statusget_productquery_products

Content & Spam

6
run_spam_checkget_spam_checkclassify_contentrun_server_testget_server_testlist_server_tests

Suppression

5
add_suppressionremove_suppressioncheck_suppressionsuppression_auditsuppression_stats

Validation Policies

5
create_policy_from_presetlist_policiestest_policyenforce_policydelete_policy

Contact Lists

4
create_contact_listlist_contact_listsappend_contactsquery_contacts

Sending Domains

2
add_sending_domainlist_sending_domains

Telemetry

4
get_telemetrywatch_telemetryget_sending_statsget_provider_intelligence

OAuth

2
create_oauth_applist_oauth_apps

Profiles

3
add_profileswitch_profilelist_profiles

System

2
health_checkonboarding_probe

Example Agent Conversations

Talk to your AI agent in plain English. It calls the right MCP tools automatically.

Validate my email list

List Validation + Suppression

TEXT
You: Validate the emails in contacts.csv and suppress any invalid ones

Agent: I'll validate your list and suppress any bad addresses.
  Reading contacts.csv... 419 rows, 399 unique emails (19 duplicates removed).
  validate_batch supports up to 100 per call — splitting into 5 batches.
  Batch 1/5... Batch 2/5... Batch 3/5... Batch 4/5... Batch 5/5 done.
  Results: 312 valid, 61 invalid, 26 risky (action != send)
  Adding 87 addresses to suppression list...
  Done. 87 invalid/risky emails suppressed. Your list is clean.

Check my sender health

Sender Health + DMARC Check

TEXT
You: How is my sender reputation? Check DMARC too.

Agent: Let me check your sender health and DMARC status.
  Sender Health: Score 87/100
    Bounce rate: 1.2% | Complaint rate: 0.02%
    Authentication: SPF pass, DKIM pass
  DMARC (yourdomain.com):
    Policy: quarantine | Pass rate: 98.3%
    Recommendation: Ready to move to p=reject

Investigate bounce issues

Bounce Analysis + Remediation

TEXT
You: Find out why my emails to gmail.com are bouncing

Agent: I'll investigate your Gmail bounce issues.
  1. Pulling bounce records for gmail.com...
  2. Found 34 bounces in the last 7 days
  3. Cross-referencing with sender health data...
  Analysis:
    Primary cause: IP reputation (78% of bounces)
    Bounce rate to Gmail: 4.1% (above 2% threshold)
    Recommendation: Reduce volume by 30% for 48 hours,
    then ramp back up. Adding 34 addresses to suppression list.

Send a campaign

Campaign Creation + Send

TEXT
You: Create a campaign for our spring sale and send to the 'active-buyers' list

Agent: Creating your spring sale campaign.
  1. Campaign created: "Spring Sale"
  2. Subscriber list 'active-buyers': 4,210 contacts
  3. Sending campaign...
  Campaign sent to 4,210 subscribers. Track results in your dashboard.

Full Platform Access Through MCP

The MailOdds MCP server exposes the full platform API surface. Anything you can do from the dashboard or REST API, an AI agent can do through MCP.

190
Tools
29
API Categories
Real-time
Execution

Frequently Asked Questions

Need more help?

Can't find what you're looking for? We're here to help you get MCP Server working.

Contact Support Full API Docs Report an Issue

Connect AI Agents to Your Email Platform

190 tools. 29 categories. Full API access through the Model Context Protocol.

Start Free Read MCP Blog Post