Analyzemail MCP server
Commit Oct 18, 2026Lets an AI agent verify email addresses in real time, clean entire list files, and download verified addresses to ensure deliverability.
Also known as analyzemail/mcp, @analyzemail/mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 days
- 444
- Latest version
- —
- Last commit
- Oct 18, 2026
- License
- MIT
What is Analyzemail MCP?
Analyzemail lets an AI agent verify email addresses in real time, clean entire list files, and download verified addresses to ensure deliverability. It exposes 5 tools, such as verify_email, get_credits, clean_list.
Summary generated from the project's README
About Analyzemail MCP server
Verifying email addresses before sending messages is what this server enables for developers using Claude or Cursor. It provides an AI agent with the ability to check individual addresses in real time or process entire files to ensure high deliverability. By using the verify_email tool, the agent can identify syntax errors, domain mail server status, and specific flags like disposable, catch-all, or spam-trap addresses.
Users set up the server via npx using an ANALYZEMAIL_API_KEY. The system includes safety mechanisms like max_credits to prevent unexpected spending during large file cleanses. For bulk operations, the clean_list tool processes CSV or TXT files, while job_status and download_results allow the agent to monitor progress and save verified addresses to a new file. Accounts with a confirmed email receive 250 free checks per month.
What you can do with it
- 1Single address verificationAsk the AI to check if a specific email address is valid and safe to use before including it in a message.
- 2Managing credit usageCheck how many credits are remaining in the account to plan large cleaning jobs.
- 3Exporting verified contactsInstruct the agent to save a cleaned list of only the verified email addresses to a new local file.
Written from the project's README. Every use case is checked against a quote from it.
How to install Analyzemail MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Analyzemail MCP in Claude Code
$ claude mcp add mcp -- npx -y @analyzemail/mcpInstall Analyzemail MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@analyzemail/mcp"
]
}
}
}Install Analyzemail MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@analyzemail/mcp"
]
}
}
}Install Analyzemail MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@analyzemail/mcp"]}'Install Analyzemail MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@analyzemail/mcp"
]
}
}
}Install Analyzemail MCP in Codex
$ codex mcp add mcp -- npx -y @analyzemail/mcpInstall Analyzemail MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@analyzemail/mcp"]
Install Analyzemail MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @analyzemail/mcpInstall Analyzemail MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@analyzemail/mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @analyzemail/mcp 0.1.0 in an isolated container with no network and no keys. It answered and listed 5 tools.
Analyzemail MCP tools 5
Read from the server with tools/listverify_emailRead-onlyChecks one address in real time: syntax, the domain and its mail servers, whether the mailbox exists, and flags for disposable, role, free, catch-all, protected, parked, spam-trap and litigator addresses. status is deliverable, undeliverable, risky or unknown. One credit, refunded when the result is unknown.
get_creditsRead-onlyCredits the account can spend now, free monthly credits included, and when the free credits reset.
clean_listActionUploads a CSV or TXT list from disk (or reuses an uploaded list_id) and starts a cleanse that checks every address: one credit per address. Refuses when the list would cost more than max_credits. Returns the job; follow it with job_status, then download_results.
job_statusRead-onlyProgress of a cleanse job. When status is complete, includes the result summary: how many addresses are deliverable, undeliverable, risky and unknown, and the flags.
download_resultsActionWrites the results of a finished job to a CSV file: the original columns of the list plus the verdict for each address. categories picks which addresses to include; the default, verified, is the list to send to. Verified addresses checked more than 7 days ago are re-checked first; if so, this returns rechecking and you should call it again once job_status says the new job is complete.
Configuration
ANALYZEMAIL_API_KEY
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableanalyzemail/mcp is public and reachablegithub.com/analyzemail/mcp ↗Pass
- Package names this repository as its source@analyzemail/mcp names analyzemail/mcp as sourcenpmjs.com/package/@analyzemail/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-18github.com/analyzemail/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @analyzemail/mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@analyzemail/mcp
Give your AI agent an email check to run before it sends.
An MCP server for Analyzemail. It lets Claude, Cursor or any MCP client verify an address in real time, clean a whole list file, and download the addresses that are safe to send to, with the reason for every one it removed.
{
"mcpServers": {
"analyzemail": {
"command": "npx",
"args": ["-y", "@analyzemail/mcp"],
"env": { "ANALYZEMAIL_API_KEY": "am_live_..." }
}
}
}
Zero dependencies. Node 20 or later. Get an API key at analyzemail.com/account/settings/api. 250 checks a month are free on any account with a confirmed email address.
Tools
| Tool | What it does | Cost |
|---|---|---|
verify_email |
Checks one address: syntax, the domain's mail servers, whether the mailbox exists, and flags for disposable, role, free, catch-all, protected, parked, spam-trap and litigator addresses. | 1 credit, refunded when the result is unknown |
get_credits |
Credits the account can spend now, free credits included, and when the free credits reset. | Free |
clean_list |
Uploads a CSV or TXT file (or reuses a list_id) and starts a cleanse of every address. Refuses when the list would cost more than max_credits. |
1 credit per address |
job_status |
Progress of a cleanse; once complete, how many addresses are deliverable, undeliverable, risky and unknown. | Free |
download_results |
Writes the finished results to a CSV: the list's original columns plus the verdict for each address. Defaults to the verified addresses, the list to send to. |
Free |
The server tells the model how to use them: verify before sending to addresses it did not
collect itself, send only to deliverable or verified, show a person the risky and
unknown ones, and never raise max_credits without the person agreeing.
Spending limits
An agent should not be able to spend more than you expect.
clean_listuploads the list, reads how many addresses it has, and refuses to start when that is more thanmax_credits(default 1,000) or more than your balance. Nothing is charged; the refusal says the cost and thelist_idto start it with once a person agrees.- Accounts that have never bought credits are limited to 2 checks a second and 500 a day. The server waits out short rate limits on its own.
- Revoke a key from your account at any time.
A typical run
clean_list { "path": "leads.csv" }
-> list 513, 1,200 addresses, job 9051 running
job_status { "job_id": 9051 }
-> complete, result 878: 1,010 deliverable, 96 undeliverable, 71 risky, 23 unknown
download_results { "result_id": 878, "out_path": "leads.verified.csv" }
-> 1,010 rows written
A verified download first re-checks verified addresses that were checked more than a week
ago, so verified means deliverable now. While that runs, download_results returns
rechecking with the count; call it again a few minutes later.
What it does not do
It does not send email. It tells your agent which addresses are safe to send to.
It does not make a mailbox exist. A mailbox that exists today can be closed tomorrow, and some mail servers (security gateways, catch-all domains) do not say whether a mailbox exists. Those come back as risky or unknown, not deliverable.
It does not decide about risky addresses. Role accounts, catch-all domains and the like are for a person to judge.
Configuration
| Variable | |
|---|---|
ANALYZEMAIL_API_KEY |
Required. Starts with am_live_. |
ANALYZEMAIL_API_URL |
Optional. Defaults to https://analyzemail.com/api/v2. |
Claude Code: claude mcp add analyzemail --env ANALYZEMAIL_API_KEY=am_live_... -- npx -y @analyzemail/mcp
Related
- send-guard, by our partner AskEleven: free local list checks with no account, and mailbox checks through Analyzemail. CLI, MCP server and library.
- inbound-guard: the other direction. Scores an incoming email as cold outreach.
- API reference and the OpenAPI spec.
License
MIT
Analyzemail MCP questions
How do I add Analyzemail MCP to Claude Code?
Run claude mcp add mcp -- npx -y @analyzemail/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Analyzemail MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Analyzemail MCP provide?
It exposes 5 tools, including verify_email, get_credits, clean_list, job_status, download_results.
How many email checks are free?
You can perform 250 checks per month for free on any account with a confirmed email address.
Does this server send emails?
No, the server only identifies which email addresses are safe to send to; it does not perform the actual sending.
Can the server guarantee a mailbox exists?
No, it cannot guarantee a mailbox exists because mailboxes can be closed and some security gateways do not disclose existence.