mxprobe 0.1.0 → 0.2.0

package/README.md

@@ -45,10 +45,13 @@ environment.
 
 ## From Node
 
-```js
+```ts
 import { createClient, checkEmails } from "mxprobe";
 const client = createClient({ apiKey: process.env.MXPROBE_API_KEY });
 const { results, summary } = await checkEmails(["a@b.com"], { hosted: true, client });
 ```
 
+Typed: `Client`, `CheckOptions`, `CheckOutput` and the response types come
+with the package; `results` is `VerifyResult[]` from `mxprobe-core`.
+
 Docs: https://mxprobe.dev. Source: https://github.com/andrewchmr/mxprobe. MIT.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { main } from "./cli.js";
+// No forced exit on success: the MCP server may still be answering a call
+// when stdin closes, and `check` has nothing left to wait for anyway.
+main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,0EAA0E;AAC1E,sEAAsE;AACtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+import { type Env } from "./config.ts";
+import { type FetchLike } from "./client.ts";
+import type { VerifierOptions } from "mxprobe-core";
+/** Anything with a write(string): process.stdout, or a buffer in tests. */
+export interface Sink {
+    write(chunk: string): unknown;
+}
+export interface CliIo {
+    stdout?: Sink;
+    stderr?: Sink;
+    env?: Env;
+    /** For tests: the fetch the hosted client uses. */
+    fetchImpl?: FetchLike;
+    /** For tests: a fake resolver for the local DNS tier. */
+    verifierOptions?: VerifierOptions;
+}
+/** Exit codes: 0 ok, 1 a kill (single address) or an API error, 2 usage. */
+export declare function main(argv: readonly string[], { stdout, stderr, env, fetchImpl, verifierOptions }?: CliIo): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsBpD,2EAA2E;AAC3E,MAAM,WAAW,IAAI;IACnB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,mDAAmD;IACnD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,yDAAyD;IACzD,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,4EAA4E;AAC5E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,MAAuB,EAAE,MAAuB,EAAE,GAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAkGpL"}

package/dist/cli.js

@@ -0,0 +1,127 @@
+import { parseArgs } from "node:util";
+import { readFileSync } from "node:fs";
+import { readConfig, writeConfig, configPath } from "./config.js";
+import { createClient, checkEmails, ApiError } from "./client.js";
+import { version } from "./version.js";
+const HELP = `mxprobe ${version}: email verification for AI agents. Verdicts: send, hold, kill.
+
+Usage
+  mxprobe check <email>...            DNS tier, local, free, no key
+  mxprobe check --hosted <email>...   send the survivors to the hosted SMTP probe (1 credit each)
+  mxprobe check --file list.txt       one address per line
+  mxprobe check --json ...            print the verdict objects as JSON
+  mxprobe signup <email>              get an API key by mail, with 100 free checks
+  mxprobe balance                     credits left on the key
+  mxprobe buy [--packs N]             a Stripe Checkout link: 9 USD per 10,000 checks
+  mxprobe mcp                         start the MCP server on stdio
+
+Options
+  --smtp        run the SMTP probe locally too (needs outbound port 25; most laptops and clouds block it)
+  --api-url     hosted API base (default https://api.mxprobe.dev)
+
+Key: MXPROBE_API_KEY in the environment, else ${configPath()}
+Docs: https://mxprobe.dev`;
+/** Exit codes: 0 ok, 1 a kill (single address) or an API error, 2 usage. */
+export async function main(argv, { stdout = process.stdout, stderr = process.stderr, env = process.env, fetchImpl, verifierOptions } = {}) {
+    const { values, positionals } = parseArgs({
+        args: [...argv],
+        allowPositionals: true,
+        options: {
+            hosted: { type: "boolean", default: false },
+            smtp: { type: "boolean", default: false },
+            json: { type: "boolean", default: false },
+            file: { type: "string" },
+            packs: { type: "string", default: "1" },
+            "api-url": { type: "string" },
+            help: { type: "boolean", short: "h", default: false },
+            version: { type: "boolean", short: "v", default: false },
+        },
+    });
+    if (values.version) {
+        stdout.write(`${version}\n`);
+        return 0;
+    }
+    const [command, ...rest] = positionals;
+    if (values.help || !command || command === "help") {
+        stdout.write(HELP + "\n");
+        return 0;
+    }
+    const cfg = readConfig(env);
+    if (values["api-url"])
+        cfg.apiUrl = values["api-url"].replace(/\/$/, "");
+    const client = createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey, fetchImpl });
+    try {
+        switch (command) {
+            case "check": {
+                const emails = [...rest];
+                if (values.file) {
+                    emails.push(...readFileSync(values.file, "utf8")
+                        .split("\n")
+                        .map((l) => l.trim())
+                        .filter((l) => l && !l.startsWith("#")));
+                }
+                if (emails.length === 0) {
+                    stderr.write("usage: mxprobe check [--hosted] [--json] <email>... | --file <list>\n");
+                    return 2;
+                }
+                const out = await checkEmails(emails, { hosted: values.hosted, client, smtp: values.smtp, verifierOptions });
+                if (values.json) {
+                    stdout.write(JSON.stringify(out, null, 2) + "\n");
+                }
+                else {
+                    const width = Math.max(...out.results.map((r) => r.email.length));
+                    for (const r of out.results)
+                        stdout.write(`${r.action.padEnd(4)} ${r.verdict.padEnd(4)} ${r.email.padEnd(width)}  ${r.reason}\n`);
+                    const s = out.summary;
+                    stderr.write(`\n${s.total} checked: ${s.send} send, ${s.hold} hold, ${s.kill} kill`);
+                    if (values.hosted)
+                        stderr.write(`; ${out.hosted} probed on the hosted tier, ${out.credits_left ?? "?"} credits left`);
+                    else if (!values.smtp)
+                        stderr.write(`. DNS tier only: a send means the domain takes mail, not that the mailbox exists. Add --hosted to probe the mailbox.`);
+                    stderr.write("\n");
+                }
+                return out.summary.kill > 0 && emails.length === 1 ? 1 : 0;
+            }
+            case "signup": {
+                const email = rest[0];
+                if (!email) {
+                    stderr.write("usage: mxprobe signup <email>\n");
+                    return 2;
+                }
+                const res = await client.signup(email);
+                const path = writeConfig({ api_key: res.api_key, api_url: cfg.apiUrl, email: res.email }, env);
+                stdout.write(`Key saved to ${path}. ${res.credits} free checks on it. The key was also mailed to ${res.email}.\n`);
+                return 0;
+            }
+            case "balance": {
+                const res = await client.balance();
+                stdout.write(values.json ? JSON.stringify(res) + "\n" : `${res.credits} credits left on the key for ${res.email} (${res.checks_total} checks so far)\n`);
+                return 0;
+            }
+            case "buy": {
+                const packs = Math.max(1, Number.parseInt(values.packs, 10) || 1);
+                const res = await client.checkout(packs);
+                stdout.write(values.json ? JSON.stringify(res) + "\n" : `Pay ${res.amount_usd} USD for ${res.credits} checks here:\n${res.url}\nCredits land on the key as soon as Stripe confirms the payment.\n`);
+                return 0;
+            }
+            case "mcp": {
+                const { startMcpServer } = await import("./mcp.js");
+                await startMcpServer({ env });
+                return 0;
+            }
+            default:
+                stderr.write(`unknown command "${command}"\n\n${HELP}\n`);
+                return 2;
+        }
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            stderr.write(`${err.status}: ${err.message}\n`);
+            if (err.status === 402 && err.body.checkout_hint)
+                stderr.write(`${err.body.checkout_hint}\n`);
+            return 1;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,55 @@
+import { type ApiErrorBody, type BalanceResponse, type CheckoutResponse, type SignupResponse, type Summary, type VerifierOptions, type VerifyResponse, type VerifyResult } from "mxprobe-core";
+export type { ApiErrorBody, BalanceResponse, CheckoutResponse, SignupResponse, VerifyResponse } from "mxprobe-core";
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: Partial<ApiErrorBody>;
+    constructor(status: number, body?: Partial<ApiErrorBody>);
+}
+/** The part of `fetch` the client uses; tests pass a fake. */
+export type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}>;
+export interface ClientOptions {
+    apiUrl?: string;
+    apiKey?: string | null;
+    fetchImpl?: FetchLike;
+}
+export interface Client {
+    signup(email: string): Promise<SignupResponse>;
+    verify(emails: readonly string[]): Promise<VerifyResponse>;
+    balance(): Promise<BalanceResponse>;
+    checkout(packs?: number): Promise<CheckoutResponse>;
+}
+export declare function createClient({ apiUrl, apiKey, fetchImpl }?: ClientOptions): Client;
+export interface CheckOptions {
+    /** Send the DNS survivors to the hosted SMTP probe, one credit each. */
+    hosted?: boolean;
+    /** Needed when `hosted` is on. Only `verify` is called. */
+    client?: Pick<Client, "verify"> | null;
+    /** Run the SMTP probe locally (needs outbound port 25). */
+    smtp?: boolean;
+    verifierOptions?: VerifierOptions;
+}
+export interface CheckOutput {
+    results: VerifyResult[];
+    summary: Summary;
+    /** How many results came from the hosted tier. */
+    hosted: number;
+    /** Credits left on the key after the hosted calls, when any were made. */
+    credits_left: number | null;
+}
+/** The hosted API takes at most this many addresses per call. */
+export declare const HOSTED_BATCH = 100;
+/**
+ * The two-tier check the CLI and the MCP server share. The DNS tier runs
+ * locally and is free; with `hosted` on, the survivors (send and hold) go to
+ * the hosted SMTP probe, one credit each. A DNS kill never costs a credit.
+ */
+export declare function checkEmails(emails: readonly string[], { hosted, client, smtp, verifierOptions }?: CheckOptions): Promise<CheckOutput>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAItB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAErC,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,OAAO,CAAC,YAAY,CAAM,EAK3D;CACF;AAED,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAErL,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACrD;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAwB,EAAE,MAAa,EAAE,SAAiB,EAAE,GAAE,aAAkB,GAAG,MAAM,CA2BvH;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,iEAAiE;AACjE,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,MAAc,EAAE,MAAa,EAAE,IAAY,EAAE,eAAoB,EAAE,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAyB3K"}

package/dist/client.js

@@ -0,0 +1,79 @@
+// The hosted API client. Also the package's main export, so a Node agent can
+// `import { createClient } from "mxprobe"` without the CLI.
+import { createVerifier, summarize, } from "mxprobe-core";
+import { DEFAULT_API_URL } from "./config.js";
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body = {}) {
+        super(body.message || body.error || `HTTP ${status}`);
+        this.name = "ApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+export function createClient({ apiUrl = DEFAULT_API_URL, apiKey = null, fetchImpl = fetch } = {}) {
+    const base = apiUrl.replace(/\/$/, "");
+    async function call(method, path, body, { auth = true } = {}) {
+        const headers = { "content-type": "application/json", "user-agent": "mxprobe-cli" };
+        if (auth) {
+            if (!apiKey)
+                throw new ApiError(401, { error: "no_api_key", message: "No API key. Run `mxprobe signup you@company.com` or set MXPROBE_API_KEY." });
+            headers["authorization"] = `Bearer ${apiKey}`;
+        }
+        const res = await fetchImpl(`${base}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined });
+        const text = await res.text();
+        let json;
+        try {
+            json = text ? JSON.parse(text) : {};
+        }
+        catch {
+            json = { error: "bad_response", message: text.slice(0, 200) };
+        }
+        if (!res.ok)
+            throw new ApiError(res.status, typeof json === "object" && json !== null ? json : {});
+        return json;
+    }
+    return {
+        signup: (email) => call("POST", "/v1/signup", { email }, { auth: false }),
+        verify: (emails) => call("POST", "/v1/verify", { emails }),
+        balance: () => call("GET", "/v1/balance"),
+        checkout: (packs = 1) => call("POST", "/v1/credits/checkout", { packs }),
+    };
+}
+/** The hosted API takes at most this many addresses per call. */
+export const HOSTED_BATCH = 100;
+/**
+ * The two-tier check the CLI and the MCP server share. The DNS tier runs
+ * locally and is free; with `hosted` on, the survivors (send and hold) go to
+ * the hosted SMTP probe, one credit each. A DNS kill never costs a credit.
+ */
+export async function checkEmails(emails, { hosted = false, client = null, smtp = false, verifierOptions = {} } = {}) {
+    const local = createVerifier({ ...verifierOptions, smtp });
+    const results = await local.verifyBatch(emails);
+    let hostedCount = 0;
+    let creditsLeft = null;
+    if (hosted) {
+        if (!client)
+            throw new Error("hosted check needs an API client");
+        const survivors = results.filter((r) => r.action !== "kill").map((r) => r.email);
+        if (survivors.length) {
+            const byEmail = new Map();
+            for (let i = 0; i < survivors.length; i += HOSTED_BATCH) {
+                const res = await client.verify(survivors.slice(i, i + HOSTED_BATCH));
+                for (const r of res.results)
+                    byEmail.set(r.email, r);
+                creditsLeft = res.credits_left ?? creditsLeft;
+            }
+            for (const [i, r] of results.entries()) {
+                const h = byEmail.get(r.email);
+                if (h) {
+                    results[i] = h;
+                    hostedCount++;
+                }
+            }
+        }
+    }
+    return { results, summary: summarize(results), hosted: hostedCount, credits_left: creditsLeft };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFAULT_API_URL = "https://api.mxprobe.dev";
+/** What the file holds. Every field is optional; unknown fields are kept. */
+export interface ConfigFile {
+    api_key?: string;
+    api_url?: string;
+    email?: string;
+}
+/** The effective config: environment over file over defaults. */
+export interface Config {
+    apiKey: string | null;
+    apiUrl: string;
+    email: string | null;
+}
+export type Env = NodeJS.ProcessEnv;
+export declare function configPath(env?: Env): string;
+export declare function readConfig(env?: Env): Config;
+/** Merge `patch` into the file (mode 0600) and return its path. */
+export declare function writeConfig(patch: ConfigFile, env?: Env): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;AAEpC,wBAAgB,UAAU,CAAC,GAAG,GAAE,GAAiB,GAAG,MAAM,CAGzD;AAWD,wBAAgB,UAAU,CAAC,GAAG,GAAE,GAAiB,GAAG,MAAM,CAOzD;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAE,GAAiB,GAAG,MAAM,CAM7E"}

package/dist/config.js

@@ -0,0 +1,36 @@
+// Where the API key lives: MXPROBE_API_KEY in the environment wins, then
+// ~/.config/mxprobe/config.json (written by `mxprobe signup`).
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_API_URL = "https://api.mxprobe.dev";
+export function configPath(env = process.env) {
+    const base = env["XDG_CONFIG_HOME"] || join(env["HOME"] || homedir(), ".config");
+    return join(base, "mxprobe", "config.json");
+}
+function readFile(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {}; // no file yet, or not JSON
+    }
+}
+export function readConfig(env = process.env) {
+    const file = readFile(configPath(env));
+    return {
+        apiKey: env["MXPROBE_API_KEY"] || file.api_key || null,
+        apiUrl: (env["MXPROBE_API_URL"] || file.api_url || DEFAULT_API_URL).replace(/\/$/, ""),
+        email: file.email || null,
+    };
+}
+/** Merge `patch` into the file (mode 0600) and return its path. */
+export function writeConfig(patch, env = process.env) {
+    const path = configPath(env);
+    const next = { ...readFile(path), ...patch };
+    mkdirSync(join(path, ".."), { recursive: true });
+    writeFileSync(path, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
+    return path;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAkBzD,MAAM,UAAU,UAAU,CAAC,GAAG,GAAQ,OAAO,CAAC,GAAG;IAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,2BAA2B;IACxC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,GAAQ,OAAO,CAAC,GAAG;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;QACtD,MAAM,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACtF,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,GAAG,GAAQ,OAAO,CAAC,GAAG;IACnE,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAe,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IACzD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ApiError, HOSTED_BATCH, checkEmails, createClient } from "./client.ts";
+export type { ApiErrorBody, BalanceResponse, CheckOptions, CheckOutput, CheckoutResponse, Client, ClientOptions, FetchLike, SignupResponse, VerifyResponse } from "./client.ts";
+export { DEFAULT_API_URL, configPath, readConfig, writeConfig } from "./config.ts";
+export type { Config, ConfigFile } from "./config.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChL,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// The package's Node API: the hosted client and the two-tier check.
+export { ApiError, HOSTED_BATCH, checkEmails, createClient } from "./client.js";
+export { DEFAULT_API_URL, configPath, readConfig, writeConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Env } from "./config.ts";
+import { type FetchLike } from "./client.ts";
+import { type VerifierOptions } from "mxprobe-core";
+export interface McpOptions {
+    env?: Env;
+    /** For tests: the fetch the hosted client uses. */
+    fetchImpl?: FetchLike;
+    /** For tests: a fake resolver for the local DNS tier. */
+    verifierOptions?: VerifierOptions;
+}
+export declare function buildMcpServer({ env, fetchImpl, verifierOptions }?: McpOptions): McpServer;
+export declare function startMcpServer(opts?: McpOptions): Promise<McpServer>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAA2B,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAiBlE,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,mDAAmD;IACnD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,yDAAyD;IACzD,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,EAAE,GAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,GAAE,UAAe,GAAG,SAAS,CA4F5G;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAM9E"}

package/dist/mcp.js

@@ -0,0 +1,103 @@
+// The MCP server: the same five things the API does, as tools an agent can
+// call. verify_email and verify_batch run the free DNS tier locally and, when
+// a key is configured, send the survivors to the hosted SMTP probe.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { readConfig, writeConfig } from "./config.js";
+import { createClient, checkEmails, ApiError } from "./client.js";
+import { version } from "./version.js";
+import { errorMessage } from "mxprobe-core";
+const VERDICT_DOC = "Each result is { email, action, verdict, reason, checks }. action is send | hold | kill: send means go ahead, hold means send only with a fallback in hand (catch-all, forwarder, greylisted or refused probe), kill means never send (no mail server, or the mailbox does not exist). checks.smtp is skipped on the free DNS tier; the hosted tier probes the mailbox.";
+function text(obj) {
+    return { content: [{ type: "text", text: JSON.stringify(obj, null, 2) }], structuredContent: obj };
+}
+function failure(err) {
+    const body = err instanceof ApiError
+        ? { error: err.body.error ?? "api_error", status: err.status, message: err.message, ...(err.body.checkout_hint ? { checkout_hint: err.body.checkout_hint } : {}) }
+        : { error: "failed", message: errorMessage(err) };
+    return { ...text(body), isError: true };
+}
+export function buildMcpServer({ env = process.env, fetchImpl, verifierOptions } = {}) {
+    const server = new McpServer({ name: "mxprobe", version });
+    // Re-read the config on every call so a signup made through the server is
+    // picked up without a restart.
+    const state = () => {
+        const cfg = readConfig(env);
+        return { cfg, client: createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey, fetchImpl }) };
+    };
+    server.registerTool("verify_email", {
+        title: "Verify one email address",
+        description: `Check whether an email address can receive mail before sending to it. ${VERDICT_DOC} Uses the hosted SMTP probe (1 credit) when an API key is configured and hosted is not false; otherwise the free local DNS tier.`,
+        inputSchema: { email: z.string().describe("The address to check"), hosted: z.boolean().optional().describe("Probe the mailbox on the hosted tier (default: yes when a key is configured)") },
+    }, async ({ email, hosted }) => {
+        try {
+            const { cfg, client } = state();
+            const useHosted = hosted ?? !!cfg.apiKey;
+            const out = await checkEmails([email], { hosted: useHosted, client, verifierOptions });
+            return text({ ...out.results[0], hosted: useHosted, credits_left: out.credits_left });
+        }
+        catch (err) {
+            return failure(err);
+        }
+    });
+    server.registerTool("verify_batch", {
+        title: "Verify a list of email addresses",
+        description: `Check up to 500 addresses in one call. ${VERDICT_DOC} DNS kills cost nothing; with a key the survivors go to the hosted probe at 1 credit each.`,
+        inputSchema: { emails: z.array(z.string()).min(1).max(500).describe("The addresses to check"), hosted: z.boolean().optional().describe("Probe mailboxes on the hosted tier (default: yes when a key is configured)") },
+    }, async ({ emails, hosted }) => {
+        try {
+            const { cfg, client } = state();
+            const useHosted = hosted ?? !!cfg.apiKey;
+            const out = await checkEmails(emails, { hosted: useHosted, client, verifierOptions });
+            return text({ results: out.results, summary: out.summary, hosted: useHosted, credits_left: out.credits_left });
+        }
+        catch (err) {
+            return failure(err);
+        }
+    });
+    server.registerTool("signup", {
+        title: "Create an MX Probe API key",
+        description: "Sign up with an email address. Returns an API key with 100 free checks and saves it locally for the other tools. The key is also mailed to the address. One key per address.",
+        inputSchema: { email: z.string().describe("The operator's email address, where the key is mailed") },
+    }, async ({ email }) => {
+        try {
+            const { cfg, client } = state();
+            const res = await client.signup(email);
+            const path = writeConfig({ api_key: res.api_key, api_url: cfg.apiUrl, email: res.email }, env);
+            return text({ ok: true, email: res.email, credits: res.credits, api_key: res.api_key, saved_to: path, message: res.message });
+        }
+        catch (err) {
+            return failure(err);
+        }
+    });
+    server.registerTool("balance", { title: "Credits left", description: "How many hosted checks are left on the configured API key.", inputSchema: {} }, async () => {
+        try {
+            return text(await state().client.balance());
+        }
+        catch (err) {
+            return failure(err);
+        }
+    });
+    server.registerTool("buy_credits", {
+        title: "Buy credits",
+        description: "Get a Stripe Checkout link for more hosted checks: 9 USD per 10,000, one payment, credits never expire. Open the link to pay; credits land on the key when Stripe confirms.",
+        inputSchema: { packs: z.number().int().min(1).max(100).optional().describe("How many packs of 10,000 (default 1)") },
+    }, async ({ packs }) => {
+        try {
+            return text(await state().client.checkout(packs ?? 1));
+        }
+        catch (err) {
+            return failure(err);
+        }
+    });
+    return server;
+}
+export async function startMcpServer(opts = {}) {
+    const server = buildMcpServer(opts);
+    await server.connect(new StdioServerTransport());
+    // The transport keeps the process alive while stdin is open; when the
+    // client closes it, in-flight calls finish and the loop drains on its own.
+    return server;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** The package version, read from package.json at runtime. */
+export declare const version: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from "node:module";
+const pkg = createRequire(import.meta.url)("../package.json");
+/** The package version, read from package.json at runtime. */
+export const version = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAErF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "mxprobe",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Email verification for AI agents. One call returns send, hold or kill with the reason. Free DNS tier runs locally; the hosted SMTP probe is 9 USD per 10,000 checks. CLI + MCP server.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "mxprobe": "./bin/mxprobe.mjs"
+    "mxprobe": "./dist/bin.js"
   },
-  "main": "./src/client.mjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/client.mjs"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "files": [
-    "bin",
+    "dist",
+    "!dist/.tsbuildinfo",
     "src",
     "README.md"
   ],
@@ -40,9 +45,15 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.5.4",
-    "mxprobe-core": "^0.1.0"
+    "mxprobe-core": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24",
+    "typescript": "^7.0.2"
   },
   "scripts": {
-    "test": "node --test test/*.test.mjs"
+    "build": "tsc -b",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "node --test test/*.test.ts"
   }
 }

package/{bin/mxprobe.mjs → src/bin.ts}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { main } from "../src/cli.mjs";
+import { main } from "./cli.ts";
 
 // No forced exit on success: the MCP server may still be answering a call
 // when stdin closes, and `check` has nothing left to wait for anyway.
 main(process.argv.slice(2)).then(
   (code) => {
-    process.exitCode = code ?? 0;
+    process.exitCode = code;
   },
-  (err) => {
-    console.error(err?.message ?? err);
+  (err: unknown) => {
+    console.error(err instanceof Error ? err.message : err);
     process.exit(1);
   },
 );

package/src/{cli.mjs → cli.ts}

@@ -1,11 +1,9 @@
 import { parseArgs } from "node:util";
 import { readFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { readConfig, writeConfig, configPath } from "./config.mjs";
-import { createClient, checkEmails, ApiError } from "./client.mjs";
-
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json");
+import { readConfig, writeConfig, configPath, type Env } from "./config.ts";
+import { createClient, checkEmails, ApiError, type FetchLike } from "./client.ts";
+import type { VerifierOptions } from "mxprobe-core";
+import { version } from "./version.ts";
 
 const HELP = `mxprobe ${version}: email verification for AI agents. Verdicts: send, hold, kill.
 
@@ -26,9 +24,25 @@ Options
 Key: MXPROBE_API_KEY in the environment, else ${configPath()}
 Docs: https://mxprobe.dev`;
 
-export async function main(argv, { stdout = process.stdout, stderr = process.stderr, env = process.env } = {}) {
+/** Anything with a write(string): process.stdout, or a buffer in tests. */
+export interface Sink {
+  write(chunk: string): unknown;
+}
+
+export interface CliIo {
+  stdout?: Sink;
+  stderr?: Sink;
+  env?: Env;
+  /** For tests: the fetch the hosted client uses. */
+  fetchImpl?: FetchLike;
+  /** For tests: a fake resolver for the local DNS tier. */
+  verifierOptions?: VerifierOptions;
+}
+
+/** Exit codes: 0 ok, 1 a kill (single address) or an API error, 2 usage. */
+export async function main(argv: readonly string[], { stdout = process.stdout, stderr = process.stderr, env = process.env, fetchImpl, verifierOptions }: CliIo = {}): Promise<number> {
   const { values, positionals } = parseArgs({
-    args: argv,
+    args: [...argv],
     allowPositionals: true,
     options: {
       hosted: { type: "boolean", default: false },
@@ -41,13 +55,19 @@ export async function main(argv, { stdout = process.stdout, stderr = process.std
       version: { type: "boolean", short: "v", default: false },
     },
   });
-  if (values.version) return void stdout.write(`${version}\n`);
+  if (values.version) {
+    stdout.write(`${version}\n`);
+    return 0;
+  }
   const [command, ...rest] = positionals;
-  if (values.help || !command || command === "help") return void stdout.write(HELP + "\n");
+  if (values.help || !command || command === "help") {
+    stdout.write(HELP + "\n");
+    return 0;
+  }
 
   const cfg = readConfig(env);
   if (values["api-url"]) cfg.apiUrl = values["api-url"].replace(/\/$/, "");
-  const client = createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey });
+  const client = createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey, fetchImpl });
 
   try {
     switch (command) {
@@ -65,7 +85,7 @@ export async function main(argv, { stdout = process.stdout, stderr = process.std
           stderr.write("usage: mxprobe check [--hosted] [--json] <email>... | --file <list>\n");
           return 2;
         }
-        const out = await checkEmails(emails, { hosted: values.hosted, client, smtp: values.smtp });
+        const out = await checkEmails(emails, { hosted: values.hosted, client, smtp: values.smtp, verifierOptions });
         if (values.json) {
           stdout.write(JSON.stringify(out, null, 2) + "\n");
         } else {
@@ -102,8 +122,8 @@ export async function main(argv, { stdout = process.stdout, stderr = process.std
         return 0;
       }
       case "mcp": {
-        const { startMcpServer } = await import("./mcp.mjs");
-        await startMcpServer({ client, config: cfg, env });
+        const { startMcpServer } = await import("./mcp.ts");
+        await startMcpServer({ env });
         return 0;
       }
       default:
@@ -113,7 +133,7 @@ export async function main(argv, { stdout = process.stdout, stderr = process.std
   } catch (err) {
     if (err instanceof ApiError) {
       stderr.write(`${err.status}: ${err.message}\n`);
-      if (err.status === 402 && err.body?.checkout_hint) stderr.write(`${err.body.checkout_hint}\n`);
+      if (err.status === 402 && err.body.checkout_hint) stderr.write(`${err.body.checkout_hint}\n`);
       return 1;
     }
     throw err;

package/src/client.ts

@@ -0,0 +1,129 @@
+// The hosted API client. Also the package's main export, so a Node agent can
+// `import { createClient } from "mxprobe"` without the CLI.
+import {
+  createVerifier,
+  summarize,
+  type ApiErrorBody,
+  type BalanceResponse,
+  type CheckoutResponse,
+  type SignupResponse,
+  type Summary,
+  type VerifierOptions,
+  type VerifyResponse,
+  type VerifyResult,
+} from "mxprobe-core";
+
+import { DEFAULT_API_URL } from "./config.ts";
+
+export type { ApiErrorBody, BalanceResponse, CheckoutResponse, SignupResponse, VerifyResponse } from "mxprobe-core";
+
+export class ApiError extends Error {
+  readonly status: number;
+  readonly body: Partial<ApiErrorBody>;
+
+  constructor(status: number, body: Partial<ApiErrorBody> = {}) {
+    super(body.message || body.error || `HTTP ${status}`);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+
+/** The part of `fetch` the client uses; tests pass a fake. */
+export type FetchLike = (url: string, init: { method: string; headers: Record<string, string>; body?: string }) => Promise<{ ok: boolean; status: number; text(): Promise<string> }>;
+
+export interface ClientOptions {
+  apiUrl?: string;
+  apiKey?: string | null;
+  fetchImpl?: FetchLike;
+}
+
+export interface Client {
+  signup(email: string): Promise<SignupResponse>;
+  verify(emails: readonly string[]): Promise<VerifyResponse>;
+  balance(): Promise<BalanceResponse>;
+  checkout(packs?: number): Promise<CheckoutResponse>;
+}
+
+export function createClient({ apiUrl = DEFAULT_API_URL, apiKey = null, fetchImpl = fetch }: ClientOptions = {}): Client {
+  const base = apiUrl.replace(/\/$/, "");
+
+  async function call<T>(method: string, path: string, body?: object, { auth = true } = {}): Promise<T> {
+    const headers: Record<string, string> = { "content-type": "application/json", "user-agent": "mxprobe-cli" };
+    if (auth) {
+      if (!apiKey) throw new ApiError(401, { error: "no_api_key", message: "No API key. Run `mxprobe signup you@company.com` or set MXPROBE_API_KEY." });
+      headers["authorization"] = `Bearer ${apiKey}`;
+    }
+    const res = await fetchImpl(`${base}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined });
+    const text = await res.text();
+    let json: unknown;
+    try {
+      json = text ? JSON.parse(text) : {};
+    } catch {
+      json = { error: "bad_response", message: text.slice(0, 200) };
+    }
+    if (!res.ok) throw new ApiError(res.status, typeof json === "object" && json !== null ? (json as Partial<ApiErrorBody>) : {});
+    return json as T;
+  }
+
+  return {
+    signup: (email) => call<SignupResponse>("POST", "/v1/signup", { email }, { auth: false }),
+    verify: (emails) => call<VerifyResponse>("POST", "/v1/verify", { emails }),
+    balance: () => call<BalanceResponse>("GET", "/v1/balance"),
+    checkout: (packs = 1) => call<CheckoutResponse>("POST", "/v1/credits/checkout", { packs }),
+  };
+}
+
+export interface CheckOptions {
+  /** Send the DNS survivors to the hosted SMTP probe, one credit each. */
+  hosted?: boolean;
+  /** Needed when `hosted` is on. Only `verify` is called. */
+  client?: Pick<Client, "verify"> | null;
+  /** Run the SMTP probe locally (needs outbound port 25). */
+  smtp?: boolean;
+  verifierOptions?: VerifierOptions;
+}
+
+export interface CheckOutput {
+  results: VerifyResult[];
+  summary: Summary;
+  /** How many results came from the hosted tier. */
+  hosted: number;
+  /** Credits left on the key after the hosted calls, when any were made. */
+  credits_left: number | null;
+}
+
+/** The hosted API takes at most this many addresses per call. */
+export const HOSTED_BATCH = 100;
+
+/**
+ * The two-tier check the CLI and the MCP server share. The DNS tier runs
+ * locally and is free; with `hosted` on, the survivors (send and hold) go to
+ * the hosted SMTP probe, one credit each. A DNS kill never costs a credit.
+ */
+export async function checkEmails(emails: readonly string[], { hosted = false, client = null, smtp = false, verifierOptions = {} }: CheckOptions = {}): Promise<CheckOutput> {
+  const local = createVerifier({ ...verifierOptions, smtp });
+  const results = await local.verifyBatch(emails);
+  let hostedCount = 0;
+  let creditsLeft: number | null = null;
+  if (hosted) {
+    if (!client) throw new Error("hosted check needs an API client");
+    const survivors = results.filter((r) => r.action !== "kill").map((r) => r.email);
+    if (survivors.length) {
+      const byEmail = new Map<string, VerifyResult>();
+      for (let i = 0; i < survivors.length; i += HOSTED_BATCH) {
+        const res = await client.verify(survivors.slice(i, i + HOSTED_BATCH));
+        for (const r of res.results) byEmail.set(r.email, r);
+        creditsLeft = res.credits_left ?? creditsLeft;
+      }
+      for (const [i, r] of results.entries()) {
+        const h = byEmail.get(r.email);
+        if (h) {
+          results[i] = h;
+          hostedCount++;
+        }
+      }
+    }
+  }
+  return { results, summary: summarize(results), hosted: hostedCount, credits_left: creditsLeft };
+}

package/src/config.ts

@@ -0,0 +1,55 @@
+// Where the API key lives: MXPROBE_API_KEY in the environment wins, then
+// ~/.config/mxprobe/config.json (written by `mxprobe signup`).
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export const DEFAULT_API_URL = "https://api.mxprobe.dev";
+
+/** What the file holds. Every field is optional; unknown fields are kept. */
+export interface ConfigFile {
+  api_key?: string;
+  api_url?: string;
+  email?: string;
+}
+
+/** The effective config: environment over file over defaults. */
+export interface Config {
+  apiKey: string | null;
+  apiUrl: string;
+  email: string | null;
+}
+
+export type Env = NodeJS.ProcessEnv;
+
+export function configPath(env: Env = process.env): string {
+  const base = env["XDG_CONFIG_HOME"] || join(env["HOME"] || homedir(), ".config");
+  return join(base, "mxprobe", "config.json");
+}
+
+function readFile(path: string): ConfigFile {
+  try {
+    const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? (parsed as ConfigFile) : {};
+  } catch {
+    return {}; // no file yet, or not JSON
+  }
+}
+
+export function readConfig(env: Env = process.env): Config {
+  const file = readFile(configPath(env));
+  return {
+    apiKey: env["MXPROBE_API_KEY"] || file.api_key || null,
+    apiUrl: (env["MXPROBE_API_URL"] || file.api_url || DEFAULT_API_URL).replace(/\/$/, ""),
+    email: file.email || null,
+  };
+}
+
+/** Merge `patch` into the file (mode 0600) and return its path. */
+export function writeConfig(patch: ConfigFile, env: Env = process.env): string {
+  const path = configPath(env);
+  const next: ConfigFile = { ...readFile(path), ...patch };
+  mkdirSync(join(path, ".."), { recursive: true });
+  writeFileSync(path, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
+  return path;
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// The package's Node API: the hosted client and the two-tier check.
+export { ApiError, HOSTED_BATCH, checkEmails, createClient } from "./client.ts";
+export type { ApiErrorBody, BalanceResponse, CheckOptions, CheckOutput, CheckoutResponse, Client, ClientOptions, FetchLike, SignupResponse, VerifyResponse } from "./client.ts";
+export { DEFAULT_API_URL, configPath, readConfig, writeConfig } from "./config.ts";
+export type { Config, ConfigFile } from "./config.ts";

package/src/{mcp.mjs → mcp.ts}

@@ -3,34 +3,44 @@
 // a key is configured, send the survivors to the hosted SMTP probe.
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
-import { createRequire } from "node:module";
-import { readConfig, writeConfig } from "./config.mjs";
-import { createClient, checkEmails, ApiError } from "./client.mjs";
-
-const require = createRequire(import.meta.url);
-const { version } = require("../package.json");
+import { readConfig, writeConfig, type Env } from "./config.ts";
+import { createClient, checkEmails, ApiError, type FetchLike } from "./client.ts";
+import { version } from "./version.ts";
+import { errorMessage, type VerifierOptions } from "mxprobe-core";
 
 const VERDICT_DOC =
   "Each result is { email, action, verdict, reason, checks }. action is send | hold | kill: send means go ahead, hold means send only with a fallback in hand (catch-all, forwarder, greylisted or refused probe), kill means never send (no mail server, or the mailbox does not exist). checks.smtp is skipped on the free DNS tier; the hosted tier probes the mailbox.";
 
-function text(obj) {
-  return { content: [{ type: "text", text: JSON.stringify(obj, null, 2) }], structuredContent: obj };
+function text(obj: object): CallToolResult {
+  return { content: [{ type: "text", text: JSON.stringify(obj, null, 2) }], structuredContent: obj as Record<string, unknown> };
 }
 
-function failure(err) {
-  const body = err instanceof ApiError ? { error: err.body?.error ?? "api_error", status: err.status, message: err.message, ...(err.body?.checkout_hint ? { checkout_hint: err.body.checkout_hint } : {}) } : { error: "failed", message: err.message };
+function failure(err: unknown): CallToolResult {
+  const body =
+    err instanceof ApiError
+      ? { error: err.body.error ?? "api_error", status: err.status, message: err.message, ...(err.body.checkout_hint ? { checkout_hint: err.body.checkout_hint } : {}) }
+      : { error: "failed", message: errorMessage(err) };
   return { ...text(body), isError: true };
 }
 
-export function buildMcpServer({ env = process.env } = {}) {
+export interface McpOptions {
+  env?: Env;
+  /** For tests: the fetch the hosted client uses. */
+  fetchImpl?: FetchLike;
+  /** For tests: a fake resolver for the local DNS tier. */
+  verifierOptions?: VerifierOptions;
+}
+
+export function buildMcpServer({ env = process.env, fetchImpl, verifierOptions }: McpOptions = {}): McpServer {
   const server = new McpServer({ name: "mxprobe", version });
 
   // Re-read the config on every call so a signup made through the server is
   // picked up without a restart.
   const state = () => {
     const cfg = readConfig(env);
-    return { cfg, client: createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey }) };
+    return { cfg, client: createClient({ apiUrl: cfg.apiUrl, apiKey: cfg.apiKey, fetchImpl }) };
   };
 
   server.registerTool(
@@ -44,7 +54,7 @@ export function buildMcpServer({ env = process.env } = {}) {
       try {
         const { cfg, client } = state();
         const useHosted = hosted ?? !!cfg.apiKey;
-        const out = await checkEmails([email], { hosted: useHosted, client });
+        const out = await checkEmails([email], { hosted: useHosted, client, verifierOptions });
         return text({ ...out.results[0], hosted: useHosted, credits_left: out.credits_left });
       } catch (err) {
         return failure(err);
@@ -63,7 +73,7 @@ export function buildMcpServer({ env = process.env } = {}) {
       try {
         const { cfg, client } = state();
         const useHosted = hosted ?? !!cfg.apiKey;
-        const out = await checkEmails(emails, { hosted: useHosted, client });
+        const out = await checkEmails(emails, { hosted: useHosted, client, verifierOptions });
         return text({ results: out.results, summary: out.summary, hosted: useHosted, credits_left: out.credits_left });
       } catch (err) {
         return failure(err);
@@ -90,17 +100,13 @@ export function buildMcpServer({ env = process.env } = {}) {
     },
   );
 
-  server.registerTool(
-    "balance",
-    { title: "Credits left", description: "How many hosted checks are left on the configured API key.", inputSchema: {} },
-    async () => {
-      try {
-        return text(await state().client.balance());
-      } catch (err) {
-        return failure(err);
-      }
-    },
-  );
+  server.registerTool("balance", { title: "Credits left", description: "How many hosted checks are left on the configured API key.", inputSchema: {} }, async () => {
+    try {
+      return text(await state().client.balance());
+    } catch (err) {
+      return failure(err);
+    }
+  });
 
   server.registerTool(
     "buy_credits",
@@ -121,7 +127,7 @@ export function buildMcpServer({ env = process.env } = {}) {
   return server;
 }
 
-export async function startMcpServer(opts = {}) {
+export async function startMcpServer(opts: McpOptions = {}): Promise<McpServer> {
   const server = buildMcpServer(opts);
   await server.connect(new StdioServerTransport());
   // The transport keeps the process alive while stdin is open; when the

package/src/version.ts

@@ -0,0 +1,6 @@
+import { createRequire } from "node:module";
+
+const pkg = createRequire(import.meta.url)("../package.json") as { version: string };
+
+/** The package version, read from package.json at runtime. */
+export const version: string = pkg.version;

package/src/client.mjs

@@ -1,73 +0,0 @@
-// The hosted API client. Also the package's main export, so a Node agent can
-// `import { createClient } from "mxprobe"` without the CLI.
-import { createVerifier, summarize } from "mxprobe-core";
-
-export class ApiError extends Error {
-  constructor(status, body) {
-    super(body?.message || body?.error || `HTTP ${status}`);
-    this.status = status;
-    this.body = body;
-  }
-}
-
-export function createClient({ apiUrl = "https://api.mxprobe.dev", apiKey = null, fetchImpl = fetch } = {}) {
-  const base = apiUrl.replace(/\/$/, "");
-
-  async function call(method, path, body, { auth = true } = {}) {
-    const headers = { "content-type": "application/json", "user-agent": "mxprobe-cli" };
-    if (auth) {
-      if (!apiKey) throw new ApiError(401, { error: "no_api_key", message: "No API key. Run `mxprobe signup you@company.com` or set MXPROBE_API_KEY." });
-      headers.authorization = `Bearer ${apiKey}`;
-    }
-    const res = await fetchImpl(`${base}${path}`, { method, headers, body: body ? JSON.stringify(body) : undefined });
-    const text = await res.text();
-    let json;
-    try {
-      json = text ? JSON.parse(text) : {};
-    } catch {
-      json = { error: "bad_response", message: text.slice(0, 200) };
-    }
-    if (!res.ok) throw new ApiError(res.status, json);
-    return json;
-  }
-
-  return {
-    signup: (email) => call("POST", "/v1/signup", { email }, { auth: false }),
-    verify: (emails) => call("POST", "/v1/verify", { emails }),
-    balance: () => call("GET", "/v1/balance"),
-    checkout: (packs = 1) => call("POST", "/v1/credits/checkout", { packs }),
-  };
-}
-
-/**
- * The two-tier check the CLI and the MCP server share. The DNS tier runs
- * locally and is free; with `hosted` on, the survivors (send and hold) go to
- * the hosted SMTP probe, one credit each. A DNS kill never costs a credit.
- */
-export async function checkEmails(emails, { hosted = false, client = null, smtp = false, verifierOptions = {} } = {}) {
-  const local = createVerifier({ ...verifierOptions, smtp });
-  const results = await local.verifyBatch(emails);
-  let hostedCount = 0;
-  let creditsLeft = null;
-  if (hosted) {
-    if (!client) throw new Error("hosted check needs an API client");
-    const survivors = results.filter((r) => r.action !== "kill").map((r) => r.email);
-    if (survivors.length) {
-      const byEmail = new Map();
-      for (let i = 0; i < survivors.length; i += 100) {
-        const chunk = survivors.slice(i, i + 100);
-        const res = await client.verify(chunk);
-        for (const r of res.results) byEmail.set(r.email, r);
-        creditsLeft = res.credits_left ?? creditsLeft;
-      }
-      for (let i = 0; i < results.length; i++) {
-        const h = byEmail.get(results[i].email);
-        if (h) {
-          results[i] = h;
-          hostedCount++;
-        }
-      }
-    }
-  }
-  return { results, summary: summarize(results), hosted: hostedCount, credits_left: creditsLeft };
-}

package/src/config.mjs

@@ -1,40 +0,0 @@
-// Where the API key lives: MXPROBE_API_KEY in the environment wins, then
-// ~/.config/mxprobe/config.json (written by `mxprobe signup`).
-import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-export const DEFAULT_API_URL = "https://api.mxprobe.dev";
-
-export function configPath(env = process.env) {
-  const base = env.XDG_CONFIG_HOME || join(env.HOME || homedir(), ".config");
-  return join(base, "mxprobe", "config.json");
-}
-
-export function readConfig(env = process.env) {
-  let file = {};
-  try {
-    file = JSON.parse(readFileSync(configPath(env), "utf8"));
-  } catch {
-    /* no file yet */
-  }
-  return {
-    apiKey: env.MXPROBE_API_KEY || file.api_key || null,
-    apiUrl: (env.MXPROBE_API_URL || file.api_url || DEFAULT_API_URL).replace(/\/$/, ""),
-    email: file.email || null,
-  };
-}
-
-export function writeConfig(patch, env = process.env) {
-  const path = configPath(env);
-  let file = {};
-  try {
-    file = JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    /* new file */
-  }
-  const next = { ...file, ...patch };
-  mkdirSync(join(path, ".."), { recursive: true });
-  writeFileSync(path, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
-  return path;
-}