Skip to main content
Glama
Sign In
Lead Cleanup MCP Lite

Lead Cleanup MCP Lite

by digitalsolutionsmagic
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Lead Cleanup MCP Lite

A free, minimal Model Context Protocol server that cleans and de-duplicates sales lead lists. It runs locally, needs no API keys, and makes no network calls.

Tools

Tool

What it does

clean_leads

Takes a list of leads (name, email, phone, company, website). Normalizes names, emails, phone numbers and website domains, drops leads with invalid emails, and removes duplicates by email. Returns the cleaned list plus counts.

validate_email

Checks whether an email address has a valid format (no network lookup).

Related MCP server: @mcpx-digital/csv-tools

Install

Requires Node.js 18 or newer.

git clone https://github.com/digitalsolutionsmagic/lead-cleanup-mcp-lite.git
cd lead-cleanup-mcp-lite
npm install
npm run sample   # runs the cleaning logic on examples/sample-leads.json

Add to an MCP client

Example config for Claude Desktop or any client that uses an mcpServers block (replace the path with your own):

{
  "mcpServers": {
    "lead-cleanup-lite": {
      "command": "node",
      "args": ["/full/path/to/lead-cleanup-mcp-lite/src/index.js"]
    }
  }
}

Example

Input (examples/sample-leads.json) has three rows: one messy valid lead, a duplicate of it, and one with an invalid email. Output:

{
  "cleaned": [
    {
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "phone": "5551234567",
      "company": "Acme Inc",
      "website": "acme.com"
    }
  ],
  "stats": { "input": 3, "kept": 1, "invalid_email": 1, "duplicates": 1 }
}

Full version

This Lite version covers cleanup only. The full Lead Enrichment & Cleanup MCP Skill adds AI-powered lead enrichment using Gemini and is available on the author's store:

https://www.getly.store/store/ai-magic-mvh6ijc8

License

MIT. See LICENSE.

Available Tools

2 tools
clean_leadsA

Clean a list of sales leads: normalize names, emails, phones and websites, drop invalid emails and remove duplicates.

Inputs: leads (required).

validate_emailA

Check whether an email address has a valid format (no network lookup).

Inputs: email (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation3/5

    Both tools operate on email validity: clean_leads already drops invalid emails, so validate_email is essentially a single-item subset of the bulk tool. The descriptions do clarify scope (one address vs. a whole list), which keeps an agent from complete confusion, but the boundaries overlap.

    Naming Consistency5/5

    Both names follow the same verb_noun snake_case pattern (clean_leads, validate_email) and the verbs accurately describe the actions.

    Tool Count3/5

    Two tools is thin even for a 'Lite' server; the surface is a bulk operation plus one narrow helper rather than a balanced set. It is not egregiously over- or under-scoped, but it sits at the borderline.

    Completeness4/5

    clean_leads covers the core domain (normalize names, emails, phones, websites, drop invalid, dedupe) and validate_email gives a quick single-address check. Minor gaps exist — no standalone phone/website validation or single-lead normalization, though an agent can pass a one-item list as a workaround.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • coldforge

      Makeph
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables personalized cold email outreach through research, drafting, template management, and deliverability checks, all locally with no required API keys.
      6
      MIT

    • Lead File Import Checker MCP

      mambalabsdev
      A
      license
      A
      quality
      B
      maintenance
      Enables checking lead rows, CSV files, or Apify datasets for duplicates, email syntax and risk signals, domain issues, missing fields, and stale dates, returning a per-row import, review, or reject verdict so only clean records reach a CRM or sequencer.
      1
      283 npm
      MIT