Lead File Import Checker

Check a lead file before import: duplicates, bad emails, MX, websites, and one verdict per row.

Documentation

Lead File Import Checker MCP Server

An MCP server for the Mamba Labs Lead File Import Checker actor on Apify. Give it lead rows, a CSV link, or an Apify dataset. Every row comes back with an import, review, or reject verdict and the issues behind it, so only clean rows reach your CRM or sequencer.

What it does

Checks per row: email syntax, duplicates (the way inboxes see them, so Jane+x@Stripe.com matches jane@stripe.com), free mail, role inboxes, disposable domains, DNS and MX for the email domain, one homepage read per company domain for live, parked, and company name checks, missing required fields, and stale dates. It does not verify mailboxes and never contacts a mail server. All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:

{
  "mcpServers": {
    "mamba-lead-file-import-checker": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-lead-file-import-checker"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Restart the client. The check_lead_file tool appears.

Prerequisites

Node.js 18 or newer.
An Apify API token from console.apify.com/account/integrations, set as APIFY_TOKEN. The server lists its tool without a token; a call needs one.

Example prompts

"Check this lead CSV and give me only the rows marked import."
"How many duplicates and role addresses are in this list?"
"Which of these companies have a parked or dead website?"

Tool

check_lead_file. One tool. Example arguments:

{
  "rows": [
    { "Email": "jane@stripe.com", "Company": "Stripe" },
    { "Email": "info@gong.io", "Company": "Gong" }
  ]
}

Inputs

Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and yes or no options are sent as strings.

Input	Type	Description
`rows`	array	Lead rows as objects, up to 50,000
`csv_url`	string	A public CSV link, up to 50 MB
`dataset_id`	string	An Apify dataset ID
`column_map`	object	Which column holds each field
`required_fields`	array	Fields a row must have. Default email
`checks`	array	Which checks to run. Default all
`check_websites`	string	true (default) or false
`stale_days`	string	Days before a dated row is stale
`max_rows`	string	Default 5000, at most 50000
`max_charge_usd`	string	Optional cost cap for the run

Pricing

Pay per event on Apify, billed to your Apify account. Prices in USD.

Event	Free plan	Bronze	Silver	Gold
`row-checked`, per row of your file checked	$0.002	$0.0019	$0.0018	$0.0017
`apify-actor-start`, per run start	$0.001	$0.001	$0.001	$0.001

Blank rows, rows over max_rows, and the one row a refused input writes are free.

Your keys

The actor needs no key and holds none. It reads DNS and the companies' own homepages. Mamba Labs pays the platform costs of the run.

Full actor documentation

apify.com/mambalabs/lead-file-import-checker

License

MIT. See LICENSE.