MX Probe
Email verification for AI agents: send, hold or kill with the reason. Signup and credits by API.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
mxprobeclaude mcp add mx-probe -e 'MXPROBE_API_KEY=<your mxprobe_api_key>' -- npx -y mxprobe@0.2.6 mcp
{
"mcpServers": {
"mx-probe": {
"command": "npx",
"args": [
"-y",
"mxprobe@0.2.6",
"mcp"
],
"env": {
"MXPROBE_API_KEY": "<your mxprobe_api_key>"
}
}
}
}
Variables d'environnement
MXPROBE_API_KEYsecret Hosted-tier API key from POST /v1/signup or the signup tool. Without it the verify tools run the free local DNS tier.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
MX Probe
Email verification for AI agents. One call returns send, hold or kill
for an address, with the reason. Signup and credits happen by API too, so an
outreach agent can provision itself. No form, no CAPTCHA, no dashboard.
- Site and docs: https://mxprobe.dev
- API: https://api.mxprobe.dev (it describes itself on
GET /). OpenAPI: https://mxprobe.dev/openapi.json. For agents: https://mxprobe.dev/llms.txt - npm:
mxprobe(CLI + MCP server),mxprobe-core(the engine)
npx mxprobe check hello@example.com # free DNS tier, local, no key
npx mxprobe check --hosted hello@example.com # survivors go to the hosted SMTP probe
claude mcp add mxprobe -- npx -y mxprobe mcp # the MCP server
One click: Cursor · VS Code ·
LM Studio. In Claude Code the same server also comes as a plugin:
/plugin marketplace add andrewchmr/mxprobe, then /plugin install mxprobe@mxprobe.
{
"email": "hello@example.com",
"action": "send",
"verdict": "OK",
"reason": "mailbox accepted by aspmx.l.google.com",
"checks": { "syntax": true, "mx": "aspmx.l.google.com", "smtp": "accepted", "catch_all": false }
}
action is send, hold or kill; verdict is OK, WEAK or DEAD. A
hold never becomes a kill on a refusal, a greylist or a catch-all. Only a
5xx that names the mailbox kills.
Layout
| Path | What | ||||
|---|---|---|---|---|---|
packages/core | The engine: DNS tier, SMTP probe, the verdict contract and the API's wire types. Zero dependencies. | ||||
packages/cli | `npx mxprobe check | signup | balance | buy | mcp. Also exportscreateClient`. |
server | The hosted API: node:http + node:sqlite, Stripe Checkout, Resend, Telegram. | ||||
site | The landing page, static. | ||||
deploy | Caddyfile, systemd units, the install script and the runbook. |
Develop
Everything is TypeScript (strict, ESM). Each package compiles its src/ to
dist/ with tsc -b; the published packages ship dist/ only. mxprobe and
the server import mxprobe-core through the workspace link to its dist/,
so pnpm build at the root (which runs the packages in dependency order) must
come before a single package's test or typecheck. Tests are .ts files
that Node runs directly with its built-in type stripping.
pnpm install
pnpm build # tsc -b in each package, core first
pnpm test # builds, then: fake resolver, fake SMTP server, in-memory SQLite. No network.
pnpm typecheck # the sources and the tests, without emitting
pnpm test:live # the DNS tier against the real network
pnpm check a@b.com # the CLI from this checkout
cp server/.env.example server/.env && pnpm dev:server
Node 22.18 or newer (24 recommended) to develop and to run the tests; the
compiled engine and CLI run on Node 20, the server on 22.13 or newer
(node:sqlite).
Pricing
100 checks free at signup, then 9 USD per 10,000, one payment, credits never expire. Addresses are logged for 24 hours for debugging and then deleted.
MIT.
Questions fréquentes
Qu'est-ce que MX Probe ?
Email verification for AI agents: send, hold or kill with the reason. Signup and credits by API.
Comment installer MX Probe ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add mx-probe -e 'MXPROBE_API_KEY=<your mxprobe_api_key>' -- npx -y mxprobe@0.2.6 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour MX Probe ?
Oui. Il attend MXPROBE_API_KEY, à renseigner dans sa configuration.
MX Probe est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient MX Probe ?
Il est publié par andrewchmr. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.