@webbula/mcp 1.0.0

package/dist/tools/validate-lead.js.map

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

package/dist/tools/verify-email.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `verify_email` — verify a single address (spec US1). Maps to
+ * `POST /api/v5/task/express` with one email and reshapes the single
+ * `EmailResult` into an `EmailVerificationResult` (contracts/verify_email.md).
+ *
+ * `status` is the upstream verdict verbatim; `label`, `risk`, `description`, and
+ * `usable` are a STATIC dictionary lookup of that verdict (all omitted for
+ * unknown tokens) — the wrapper performs no scoring or inference (constitution
+ * principle I). The dictionary lives in `api/enums.ts`.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { EmailResult } from "../api/types.js";
+import { type WebbulaClient } from "../api/webbula-client.js";
+import { type TrustMetadata } from "../trust.js";
+export declare const VERIFY_EMAIL_NAME = "verify_email";
+export declare const VERIFY_EMAIL_DESCRIPTION: string;
+/** Zod raw shape for the tool input (validated before any upstream call). */
+export declare const verifyEmailInputShape: {
+    readonly email: z.ZodString;
+    readonly profile: z.ZodOptional<z.ZodString>;
+};
+export interface EmailVerificationResult {
+    email: string;
+    corrected?: string;
+    /** Upstream `result` token, verbatim. */
+    status: string;
+    /** Human-readable label for `status`; omitted for unknown tokens. */
+    label?: string;
+    /** Documented risk level for `status`; omitted for unknown tokens. */
+    risk?: string;
+    /** Documented description for `status`; omitted for unknown tokens. */
+    description?: string;
+    /** Static verdict for `status`; omitted for unknown or indeterminate tokens. */
+    usable?: boolean;
+    trust?: TrustMetadata;
+}
+/** Reshape a single upstream `EmailResult` into the agent-facing verdict. */
+export declare function toVerificationResult(result: EmailResult): EmailVerificationResult;
+/** Register `verify_email` against the MCP server. */
+export declare function registerVerifyEmail(server: McpServer, client: WebbulaClient): void;

package/dist/tools/verify-email.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { lookupEmailVerdict } from "../api/enums.js";
+import { WebbulaApiError } from "../api/webbula-client.js";
+import { WEBBULA_VERIFICATION_PROFILE } from "../config.js";
+import { assembleTrust } from "../trust.js";
+import { toToolError } from "./errors.js";
+export const VERIFY_EMAIL_NAME = "verify_email";
+export const VERIFY_EMAIL_DESCRIPTION = "Verify a single email address using Webbula's 20+ year email-intelligence " +
+    "dataset. Returns a deliverability verdict, any corrected form, and a trust " +
+    "block (data provenance and activity history) so an agent can decide whether " +
+    "the address is safe to use. Real-time, single tool call.";
+/** Zod raw shape for the tool input (validated before any upstream call). */
+export const verifyEmailInputShape = {
+    email: z
+        .string()
+        .email()
+        .describe("The email address to verify."),
+    profile: z
+        .string()
+        .optional()
+        .describe("Optional Webbula hygiene profile name. Defaults to the server's configured profile."),
+};
+/** Reshape a single upstream `EmailResult` into the agent-facing verdict. */
+export function toVerificationResult(result) {
+    const out = {
+        email: result.email,
+        status: result.result,
+    };
+    if (result.corrected !== undefined && result.corrected !== result.email) {
+        out.corrected = result.corrected;
+    }
+    // Static lookup of the documented label/risk/description/usable (api/enums.ts).
+    // Unknown tokens leave every friendly field omitted (principle I — no guessing).
+    const verdict = lookupEmailVerdict(result.result);
+    if (verdict !== undefined) {
+        out.label = verdict.label;
+        out.risk = verdict.risk;
+        out.description = verdict.description;
+        if (verdict.usable !== undefined)
+            out.usable = verdict.usable;
+    }
+    const trust = assembleTrust(result);
+    if (trust !== undefined)
+        out.trust = trust;
+    return out;
+}
+/** Register `verify_email` against the MCP server. */
+export function registerVerifyEmail(server, client) {
+    server.registerTool(VERIFY_EMAIL_NAME, {
+        title: "Verify a single email",
+        description: VERIFY_EMAIL_DESCRIPTION,
+        inputSchema: verifyEmailInputShape,
+    }, async ({ email, profile }) => {
+        try {
+            const response = await client.expressHygiene({
+                emails: [email],
+                profile: profile ?? WEBBULA_VERIFICATION_PROFILE,
+            });
+            const first = response.emails?.[0];
+            if (!first) {
+                throw new WebbulaApiError("upstream", "Webbula returned no result for the address");
+            }
+            const result = toVerificationResult(first);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                structuredContent: result,
+            };
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=verify-email.js.map

package/dist/tools/verify-email.js.map

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

package/dist/trust.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The trust layer — the wrapper's differentiator (constitution principle II).
+ *
+ * `assembleTrust` builds a trust block ONLY from upstream fields that are
+ * actually present (research D6). It never fabricates a value: `confidence` and
+ * `ai_pollution_risk` are not in the current v4.2/v5 response, so they are
+ * omitted today and wired in when the API adds them. When no provenance/activity
+ * fields are present, the whole block is omitted (the function returns
+ * `undefined`).
+ */
+import type { EmailResult } from "./api/types.js";
+export interface TrustMetadata {
+    /** Static provenance — this data comes from Webbula. */
+    data_source: "webbula";
+    /** From `activity_first_seen` when present. */
+    first_seen?: string;
+    /** From `activity_most_recent_seen` when present. */
+    last_seen?: string;
+    /** From `activity_trajectory` when present. */
+    trajectory?: string;
+}
+/**
+ * Assemble the trust block from a single upstream `EmailResult`. Returns
+ * `undefined` when the upstream supplied no activity/provenance fields, so
+ * callers omit the `trust` key entirely rather than emitting a bare
+ * `{ data_source }`.
+ */
+export declare function assembleTrust(result: EmailResult): TrustMetadata | undefined;

package/dist/trust.js

@@ -0,0 +1,23 @@
+/**
+ * Assemble the trust block from a single upstream `EmailResult`. Returns
+ * `undefined` when the upstream supplied no activity/provenance fields, so
+ * callers omit the `trust` key entirely rather than emitting a bare
+ * `{ data_source }`.
+ */
+export function assembleTrust(result) {
+    const { activity_first_seen, activity_most_recent_seen, activity_trajectory } = result;
+    const hasAnyActivity = activity_first_seen !== undefined ||
+        activity_most_recent_seen !== undefined ||
+        activity_trajectory !== undefined;
+    if (!hasAnyActivity)
+        return undefined;
+    const trust = { data_source: "webbula" };
+    if (activity_first_seen !== undefined)
+        trust.first_seen = activity_first_seen;
+    if (activity_most_recent_seen !== undefined)
+        trust.last_seen = activity_most_recent_seen;
+    if (activity_trajectory !== undefined)
+        trust.trajectory = activity_trajectory;
+    return trust;
+}
+//# sourceMappingURL=trust.js.map

package/dist/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../src/trust.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,MAAM,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,GAC3E,MAAM,CAAC;IAET,MAAM,cAAc,GAClB,mBAAmB,KAAK,SAAS;QACjC,yBAAyB,KAAK,SAAS;QACvC,mBAAmB,KAAK,SAAS,CAAC;IAEpC,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,KAAK,GAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IACxD,IAAI,mBAAmB,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC;IAC9E,IAAI,yBAAyB,KAAK,SAAS;QACzC,KAAK,CAAC,SAAS,GAAG,yBAAyB,CAAC;IAC9C,IAAI,mBAAmB,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,mBAAmB,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@webbula/mcp",
+  "version": "1.0.0",
+  "description": "Webbula MCP Server — email verification, hygiene, and data-quality trust layer for AI agents",
+  "homepage": "https://github.com/webbula/webbula-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/webbula/webbula-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webbula/webbula-mcp.git"
+  },
+  "license": "MIT",
+  "author": "Webbula, LLC",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "webbula-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "email-verification",
+    "email-hygiene",
+    "data-quality",
+    "ai-agents",
+    "webbula"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist dist-test *.tsbuildinfo",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run build:test && node --test \"dist-test/tests/**/*.test.js\"",
+    "prepack": "npm run clean && npm run build",
+    "release": "semantic-release"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.0",
+    "express": "^5.1.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.39.4",
+    "semantic-release": "^25.0.5",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.61.0"
+  }
+}