English Français العربية

MX Probe

السجل الرسمي الإنتاجية

Email verification for AI agents: send, hold or kill with the reason. Signup and credits by API.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package mxprobe
Claude Code 
claude mcp add mx-probe -e 'MXPROBE_API_KEY=<your mxprobe_api_key>' -- npx -y mxprobe@0.2.6 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mx-probe": {
            "command": "npx",
            "args": [
                "-y",
                "mxprobe@0.2.6",
                "mcp"
            ],
            "env": {
                "MXPROBE_API_KEY": "<your mxprobe_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • MXPROBE_API_KEY سري Hosted-tier API key from POST /v1/signup or the signup tool. Without it the verify tools run the free local DNS tier.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MX Probe
  2. Layout
  3. Develop
  4. Pricing

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.

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

PathWhat
packages/coreThe engine: DNS tier, SMTP probe, the verdict contract and the API's wire types. Zero dependencies.
packages/cli`npx mxprobe checksignupbalancebuymcp. Also exportscreateClient`.
serverThe hosted API: node:http + node:sqlite, Stripe Checkout, Resend, Telegram.
siteThe landing page, static.
deployCaddyfile, 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.

الأسئلة الشائعة

ما هو MX Probe؟

Email verification for AI agents: send, hold or kill with the reason. Signup and credits by API.

كيف أثبّت MX Probe؟

يعمل على جهازك. في Claude Code: claude mcp add mx-probe -e 'MXPROBE_API_KEY=<your mxprobe_api_key>' -- npx -y mxprobe@0.2.6 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MX Probe إلى مفتاح API؟

نعم. يتطلب MXPROBE_API_KEY، وتضبطها في إعداداته.

هل MX Probe مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MX Probe؟

ينشره andrewchmr. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.