mcpField
M
mcp-lead-file-import-checker

mcp-lead-file-import-checker

Local
github.com/mambalabsdevBusiness & Marketing0Updated 2w ago

About mcp-lead-file-import-checker

mcp-lead-file-import-checker is an Apify-backed MCP server for checking lead files before importing them into a CRM or sequencer. It assigns each row an import, review, or reject verdict with reasons, but does not verify mailbox delivery.

Key features

  1. 01Accepts rows, CSV links, and Apify datasets
  2. 02Checks email syntax and duplicates
  3. 03Checks domain DNS, MX, and website status
  4. 04Flags free, role, and disposable email addresses
  5. 05Finds missing fields and stale records

Use cases

  1. 01Clean lead files before CRM import
  2. 02Review duplicate and role addresses in leads
  3. 03Find companies with parked or inactive websites

MCP support

It exposes the check_lead_file tool to MCP clients, starts an Apify Actor, and returns per-row check results.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"com-mambabuilt-mcp-lead-file-import-checker": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-lead-file-import-checker"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
Run commandnpx -y @mambalabsdev/mcp-lead-file-import-checker
Environment variables to set
APIFY_TOKENSecretApify API token from https://console.apify.com/account/integrations

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mambalabsdev/mcp-lead-file-import-checker1.0.0

Tools

1

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
rowsarrayNoLead rows as objects with any column names, up to 50,000. Give rows, csv_url, or dataset_id, one of them.
checksarrayNoWhich checks to run. Default all.
csv_urlstringNoA public link to a CSV file with a header row, up to 50 MB.
max_rowsstringNoCheck at most this many rows. Default 5000, at most 50000.
column_mapobjectNoWhich of your columns holds email, domain, company, first_name, last_name, and date, for example {"email": "Work Email"}. Without it common header names are read.
dataset_idstringNoAn Apify dataset ID from one of your runs.
stale_daysstringNoWith a date column in column_map, rows older than this many days get the stale issue.
check_websitesenumNotrue (default) reads each company homepage once for the live, parked, and company name checks.true | false
max_charge_usdstringNoOptional. The run stops before a charge would pass this amount.
required_fieldsarrayNoFields a row must have, or it is rejected. Default email.

Details

From the project README

Lead File Import Checker MCP Server

npm version license

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's Inside

What it does

Checks per row: email syntax, duplicates (the way inboxes see them, so [email protected] matches [email protected]), 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

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": "[email protected]", "Company": "Stripe" },
    { "Email": "[email protected]", "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.

InputTypeDescription
rowsarrayLead rows as objects, up to 50,000
csv_urlstringA public CSV link, up to 50 MB
dataset_idstringAn Apify dataset ID
column_mapobjectWhich column holds each field
required_fieldsarrayFields a row must have. Default email
checksarrayWhich checks to run. Default all
check_websitesstringtrue (default) or false
stale_daysstringDays before a dated row is stale
max_rowsstringDefault 5000, at most 50000
max_charge_usdstringOptional cost cap for the run

Pricing

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

EventFree planBronzeSilverGold
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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.