@anymailfinder/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anymail Finder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# @anymailfinder/mcp-server
+
+MCP server for the [Anymail Finder](https://anymailfinder.com) API. Lets AI assistants (Claude, Cursor, ChatGPT, etc.) find and verify email addresses natively via the [Model Context Protocol](https://modelcontextprotocol.io).
+
+## Prerequisites
+
+- **Node.js 20 or later** -- check with `node --version` ([download](https://nodejs.org))
+- **Anymail Finder API key** -- get one at [anymailfinder.com](https://newapp.anymailfinder.com/settings/api)
+
+## Available Tools
+
+| Tool | Description | Credits |
+|---|---|---|
+| `find_person_email` | Find a person's email by name + company domain | Yes |
+| `find_company_emails` | Find up to 20 emails for a company domain | Yes |
+| `find_email_by_linkedin` | Find email from a LinkedIn profile URL | Yes |
+| `find_decision_maker` | Find a decision maker's email by role category | Yes |
+| `verify_email` | Check if an email is valid, risky, or invalid | Yes |
+| `get_account_info` | Check remaining API credits | No |
+| `report_bad_email` | Report an incorrect email | No |
+
+## Setup
+
+### Claude Desktop
+
+Add to your config file:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Open it from a terminal:
+
+```bash
+# macOS
+open ~/Library/Application\ Support/Claude/claude_desktop_config.json
+
+# Windows
+notepad %APPDATA%\Claude\claude_desktop_config.json
+```
+
+```json
+{
+  "mcpServers": {
+    "anymailfinder": {
+      "command": "npx",
+      "args": ["-y", "@anymailfinder/mcp-server"],
+      "env": {
+        "ANYMAIL_FINDER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Fully quit and reopen Claude Desktop after saving (Cmd+Q on macOS).
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:
+
+```json
+{
+  "mcpServers": {
+    "anymailfinder": {
+      "command": "npx",
+      "args": ["-y", "@anymailfinder/mcp-server"],
+      "env": {
+        "ANYMAIL_FINDER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Restart Cursor after saving.
+
+## Troubleshooting
+
+### "fetch is not defined" error
+
+This means the MCP client is using a Node.js version older than 18. This commonly happens with **nvm** users because Claude Desktop and Cursor don't load your shell profile.
+
+**Fix:** replace `"npx"` with the full path to your Node binary:
+
+```json
+{
+  "mcpServers": {
+    "anymailfinder": {
+      "command": "/path/to/node",
+      "args": ["/path/to/global/node_modules/@anymailfinder/mcp-server/build/index.js"],
+      "env": {
+        "ANYMAIL_FINDER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Find your Node path with:
+
+```bash
+which node
+# e.g. /Users/you/.nvm/versions/node/v20.18.1/bin/node
+```
+
+### "ANYMAIL_FINDER_API_KEY environment variable is required"
+
+You didn't set the API key in the `env` block of your MCP config. See setup instructions above.
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ANYMAIL_FINDER_API_KEY` | Yes | — | Your Anymail Finder API key |
+| `ANYMAIL_FINDER_API_URL` | No | `https://api.anymailfinder.com` | Override API base URL |
+
+## Development
+
+```bash
+cd mcp
+yarn install
+yarn build
+
+# Test interactively with MCP Inspector
+ANYMAIL_FINDER_API_KEY=your-key npx @modelcontextprotocol/inspector node build/index.js
+
+# Run directly (stdio mode)
+ANYMAIL_FINDER_API_KEY=your-key node build/index.js
+```
+
+## License
+
+MIT

package/build/api-client.d.ts

@@ -0,0 +1,8 @@
+export declare class AnymailFinderClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor();
+    post(path: string, body: Record<string, unknown>): Promise<unknown>;
+    get(path: string): Promise<unknown>;
+    private handleResponse;
+}

package/build/api-client.js

@@ -0,0 +1,44 @@
+const DEFAULT_BASE_URL = "https://api.anymailfinder.com";
+export class AnymailFinderClient {
+    apiKey;
+    baseUrl;
+    constructor() {
+        const apiKey = process.env.ANYMAIL_FINDER_API_KEY;
+        if (!apiKey) {
+            console.error("Error: ANYMAIL_FINDER_API_KEY environment variable is required.");
+            console.error("Set it in your MCP client config or export it in your shell.");
+            process.exit(1);
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = process.env.ANYMAIL_FINDER_API_URL || DEFAULT_BASE_URL;
+    }
+    async post(path, body) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        return this.handleResponse(response);
+    }
+    async get(path) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+        });
+        return this.handleResponse(response);
+    }
+    async handleResponse(response) {
+        const data = await response.json();
+        if (!response.ok) {
+            const err = data;
+            throw new Error(`${err.error || "unknown"}: ${err.message || `HTTP ${response.status}`}`);
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/build/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEzD,MAAM,OAAO,mBAAmB;IACb,MAAM,CAAS;IACf,OAAO,CAAS;IAEjC;QACE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CACX,iEAAiE,CAClE,CAAC;YACF,OAAO,CAAC,KAAK,CACX,8DAA8D,CAC/D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,gBAAgB,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAA6B;QACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACrD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,QAAkB;QAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAA4C,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,KAAK,IAAI,SAAS,KAAK,GAAG,CAAC,OAAO,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AnymailFinderClient } from "./api-client.js";
+import { createServer } from "./server.js";
+const NODE_MAJOR = parseInt(process.versions.node.split(".")[0], 10);
+if (NODE_MAJOR < 20) {
+    console.error(`Error: Node.js 20 or later is required (current: ${process.version}).`);
+    console.error("Install Node 20+: https://nodejs.org");
+    process.exit(1);
+}
+const client = new AnymailFinderClient();
+const server = createServer(client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("Anymail Finder MCP server running on stdio");
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;IACpB,OAAO,CAAC,KAAK,CACX,oDAAoD,OAAO,CAAC,OAAO,IAAI,CACxE,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;AACzC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AnymailFinderClient } from "./api-client.js";
+export declare const createServer: (client: AnymailFinderClient) => McpServer;

package/build/server.js

@@ -0,0 +1,201 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+const formatResult = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+const formatError = (err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+};
+export const createServer = (client) => {
+    const server = new McpServer({
+        name: "anymailfinder",
+        version: "1.0.0",
+    });
+    server.registerTool("find_person_email", {
+        description: "Find a person's email using their name and company.",
+        inputSchema: z.object({
+            domain: z
+                .string()
+                .optional()
+                .describe("The company domain (recommended for better accuracy). Either domain or company name is required."),
+            company_name: z
+                .string()
+                .optional()
+                .describe("The company name. Used if domain is not provided. Either domain or company name is required."),
+            first_name: z
+                .string()
+                .optional()
+                .describe("The person's first name. Use with last name if full name is not provided."),
+            last_name: z
+                .string()
+                .optional()
+                .describe("The person's last name. Use with first name if full name is not provided."),
+            full_name: z
+                .string()
+                .optional()
+                .describe("The person's full name. Either full name OR first name + last name is required."),
+        }),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.domain)
+                body.domain = params.domain;
+            if (params.company_name)
+                body.company_name = params.company_name;
+            if (params.first_name)
+                body.first_name = params.first_name;
+            if (params.last_name)
+                body.last_name = params.last_name;
+            if (params.full_name)
+                body.full_name = params.full_name;
+            const result = await client.post("/v5.1/find-email/person", body);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("find_company_emails", {
+        description: "Find all emails at a company.",
+        inputSchema: z.object({
+            domain: z
+                .string()
+                .optional()
+                .describe("Preferred. The company's domain. If a company name is passed here, we'll attempt to find the domain."),
+            company_name: z
+                .string()
+                .optional()
+                .describe("The company name. If a domain is passed here, we'll detect and treat it accordingly."),
+            email_type: z
+                .enum(["any", "generic", "personal"])
+                .optional()
+                .describe("Specifies which type of email addresses to return: any (default, returns both generic and personal emails); generic (only role-based emails such as info@, sales@, support@); personal (only personal, individual-specific emails such as jane.doe@company.com)."),
+        }),
+    }, async (params) => {
+        try {
+            const body = {};
+            if (params.domain)
+                body.domain = params.domain;
+            if (params.company_name)
+                body.company_name = params.company_name;
+            if (params.email_type)
+                body.email_type = params.email_type;
+            const result = await client.post("/v5.1/find-email/company", body);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("find_email_by_linkedin", {
+        description: "Find emails using a LinkedIn profile URL.",
+        inputSchema: z.object({
+            linkedin_url: z
+                .string()
+                .describe("The LinkedIn profile URL of the person."),
+        }),
+    }, async (params) => {
+        try {
+            const result = await client.post("/v5.1/find-email/linkedin-url", {
+                linkedin_url: params.linkedin_url,
+            });
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("find_decision_maker", {
+        description: "Find a decision maker's email by company and role.",
+        inputSchema: z.object({
+            domain: z
+                .string()
+                .optional()
+                .describe("Preferred. The company's domain. If a company name is passed here, we'll attempt to find the domain."),
+            company_name: z
+                .string()
+                .optional()
+                .describe("The company name. If a domain is passed here, we'll detect and treat it accordingly."),
+            decision_maker_category: z
+                .array(z.string())
+                .describe("One or more categories of the decision maker(s) to search for. If multiple are provided, they are treated in order of importance and we will return the first category that resolves to a valid email."),
+        }),
+    }, async (params) => {
+        try {
+            const body = {
+                decision_maker_category: params.decision_maker_category,
+            };
+            if (params.domain)
+                body.domain = params.domain;
+            if (params.company_name)
+                body.company_name = params.company_name;
+            const result = await client.post("/v5.1/find-email/decision-maker", body);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("verify_email", {
+        description: "Verify if an email address is valid.",
+        inputSchema: z.object({
+            email: z.string().describe("The email address to validate."),
+        }),
+    }, async (params) => {
+        try {
+            const result = await client.post("/v5.1/verify-email", {
+                email: params.email,
+            });
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("get_account_info", {
+        description: "Check how many search credits are remaining on the Anymail Finder account and the associated email address. Does not consume credits.",
+        inputSchema: z.object({}),
+    }, async () => {
+        try {
+            const result = await client.get("/v5.1/account");
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.registerTool("report_bad_email", {
+        description: "Report an email address as bad or invalid to Anymail Finder. Use this when you discover an email returned by the API is incorrect or bouncing.",
+        inputSchema: z.object({
+            email: z.string().describe("The email address to report as bad."),
+            additional_info: z
+                .string()
+                .max(500)
+                .describe("Explanation of why the email is bad, e.g. 'Email bounced with permanent failure'."),
+            bounce_message: z
+                .string()
+                .optional()
+                .describe("Optional bounce message from the email server."),
+        }),
+    }, async (params) => {
+        try {
+            const body = {
+                email: params.email,
+                additional_info: params.additional_info,
+            };
+            if (params.bounce_message)
+                body.bounce_message = params.bounce_message;
+            const result = await client.post("/v5.1/report/bad-email", body);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    return server;
+};
+//# sourceMappingURL=server.js.map

package/build/server.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@anymailfinder/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Anymail Finder API - find and verify email addresses via AI assistants",
+  "author": {
+    "name": "Anymail Finder"
+  },
+  "license": "MIT",
+  "homepage": "https://anymailfinder.com",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "anymailfinder",
+    "email",
+    "email-finder",
+    "email-verification",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "type": "module",
+  "bin": {
+    "anymailfinder-mcp-server": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit && eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepublishOnly": "npm run build",
+    "start": "node build/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.0.0",
+    "eslint-plugin-simple-import-sort": "^12.0.0",
+    "globals": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "~5.7.0",
+    "typescript-eslint": "^8.0.0"
+  }
+}