Skip to main content
Glama
LeadDirect MCP

LeadDirect MCP

by weblinkify

LeadDirect MCP

Live demo: https://lead-direct-mcp.vercel.app (mock mode, runs fully in the browser) · deploys automatically on every push to main

An MCP server for B2B prospecting from Claude Desktop, Cursor or any MCP client. Describe the companies you want ("lowbed semi-trailer dealers in France, skip the big brands") and LeadDirect searches the web, reads each company's own homepage, contact, about and imprint pages, and returns the contact details the company publishes: emails (including ones hidden by Cloudflare email protection), phone numbers, and LinkedIn / Facebook / Instagram / WhatsApp / X links. New leads go into a CSV, de-duplicated by domain.

MCP server

Python 3.10+ · FastMCP · httpx · BeautifulSoup · phonenumbers · ddgs

Web demo

React 18 · TypeScript · Tailwind CSS · Vite, deployed on Vercel

LeadDirect only collects what a company publishes on its own website. It does not guess personal addresses or probe mail servers.


Tools

Tool

What it does

find_leads

Web search → one result per company domain (directories, marketplaces and social networks skipped, plus your exclude_domains) → crawl up to 6 pages per site → save new leads to leads.csv.

scrape_company

The same crawl for one URL or domain.

decode_cloudflare_email

Decodes a data-cfemail value or /cdn-cgi/l/email-protection#… link.

list_leads

Shows the latest rows of leads.csv.

Each lead lists emails with named contacts first and shared inboxes (info@, sales@, satis@, kontakt@, …) after. Asset names (logo@2x.png), placeholders (you@example.com, firstname.lastname@) and no-reply addresses are filtered out. Phone numbers are parsed with Google's libphonenumber and printed in international format; pass region (e.g. FR) so national numbers parse.


Related MCP server: @bingeljell/lead-gen-mcp

Install

git clone https://github.com/weblinkify/lead-direct-mcp
cd lead-direct-mcp
python -m venv .venv && source .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install -e .

MCP client config (claude_desktop_config.json, Cursor mcp.json, …):

{
  "mcpServers": {
    "leaddirect": {
      "command": "/ABSOLUTE/PATH/lead-direct-mcp/.venv/bin/leaddirect",
      "env": { "LEADDIRECT_OUTPUT_DIR": "~/Desktop" }
    }
  }
}

leads.csv is written to LEADDIRECT_OUTPUT_DIR, else your Desktop, else ~/LeadDirect.

Prompting tips

  1. Target and geography: the niche plus the country or region.

  2. Local-language keywords: semi-remorque surbaissée concessionnaire for France, ambalaj karton üretici for Türkiye, Landtechnik Händler for Germany.

  3. Exclusions: pass large brands and portals in exclude_domains.

  4. Qualification: ask the assistant to keep only companies that sell the product directly.

Find 10 dealers of lowbed semi-trailers in France. Search in French
("semi-remorque surbaissée concessionnaire"), region FR, and skip
schmitz-cargobull.com and krone-trailer.com. Put the results in a table with
named contacts first and their LinkedIn pages.

Web demo

cd frontend
npm install
npm run dev          # http://localhost:5173

The companies are fictional (.example domains), but the HTML extractor and the Cloudflare decoder in the demo are TypeScript ports of the server code and run for real. Paste any page's HTML to try them.

Vercel: import the repo and set Root Directory to frontend; frontend/vercel.json does the rest.

Development

make install   # dependencies and git hooks
make check     # lint, types, tests and build: everything CI runs before merge
make audit     # pip-audit and npm audit

Responsible use

Respect each website's terms and robots rules, and the email marketing law where you operate (GDPR / ePrivacy in the EU, CAN-SPAM in the US, KVKK in Türkiye). Published business contact details are not a licence to send bulk unsolicited email.

License

MIT

Available Tools

4 tools
decode_cloudflare_emailDecode Cloudflare EmailA

Decode a Cloudflare email-protection string (the data-cfemail value or the part after '#').

Inputs: encoded (required). Returns: result

find_leadsFind LeadsC

Find companies for a query and collect their published contact details.

Inputs: query (required), save, region, target_leads, +1 more. Returns: result

list_leadsList LeadsB

Show the most recent rows of leads.csv.

Inputs: limit. Returns: result

scrape_companyScrape CompanyB

Crawl one company website (homepage + contact/about/imprint pages) for published contacts.

Inputs: url_or_domain (required), region. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool has a mostly distinct role: find_leads is a query-level search, scrape_company targets a single known site, decode_cloudflare_email is a narrow utility, and list_leads reads cached results. The main risk is overlap between find_leads and scrape_company, since both 'collect published contact details', but the descriptions make the bulk-vs-single distinction clear enough.

    Naming Consistency5/5

    All four tools follow a consistent snake_case verb_noun pattern (find_leads, scrape_company, decode_cloudflare_email, list_leads). No mixing of conventions or vague verbs.

    Tool Count4/5

    Four tools cover the core lead-generation pipeline (search, scrape, decode, list) without redundancy. It is on the lean side — a couple more operations would round it out — but nothing feels extraneous.

    Completeness3/5

    The create/scrape/read path exists, but there is no way to search or filter saved leads beyond 'most recent rows', no update/delete of entries, and no export or dedupe operation. These are workable gaps but real ones for a lead-management workflow.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables B2B research by finding verified work emails, extracting contacts, detecting tech stacks, and profiling DNS and SaaS, all through a suite of MCP tools.
      -
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI-assisted B2B lead generation by discovering, extracting, scoring, and exporting company leads from any MCP-compatible agent.
      3
      10 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables finding B2B leads with verified work emails, finding and verifying email addresses, and running cold email outreach from any MCP client.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search B2B people and companies, enrich contacts with verified emails and mobile phone numbers via waterfall enrichment across 25+ providers, and export results as CSV or JSON. Supports prospecting, org mapping, candidate sourcing, and outreach workflows through OAuth-authenticated remote access from any MCP-compatible client.
      14
      MIT