Local Leads MCP server

local-leads-mcp

<!-- mcp-name: io.github.Raffaele86/local-leads-mcp -->

Find local businesses that need a website — and prove it — from your AI agent.

One MCP server that discovers local businesses via OpenStreetMap and then verifies them with the checks that separate a real lead list from a pile of false positives. Built for freelancers and agencies that use Claude, Cursor or any MCP client for prospecting.

No API keys required for the core workflow: discovery, website verification, email deliverability check and weak-site scoring all run on free, open infrastructure (Overpass, Nominatim, DNS-over-HTTPS, plain HTTP).

Why this and not a maps scraper?

The hard part of local prospecting isn't getting a list of businesses — it's not embarrassing yourself. Lead lists built from raw map data are full of traps this server checks for explicitly:

• "No website" that isn't. OSM data can be stale; a missing website tag proves nothing. verifywebsite checks apex and www and redirects (an apex domain that doesn't resolve while the site lives happily on www. is a classic false "no website"), and confirmno_website uses a web search as the final word.
• A Facebook page is not a website. Social profiles, booking aggregators (Fresha, TheFork, Treatwell…), directory listings and free subdomains (.wixsite.com, .business.site…) are classified as notownsite, not as "has a website".
• Emails that bounce. check_mx predicts deliverability before you ever write to a lead (no MX = guaranteed bounce; PEC-only domains are flagged).
• "The site is bad" needs evidence. score_website returns citable issues (no HTTPS, no mobile viewport, missing title/meta/H1, no sitemap…), not vibes — optionally with Lighthouse scores via the PageSpeed API.

Every verdict ships with the raw checks that produced it, so your agent can show its work.

Quickstart (60 seconds)

{
  "mcpServers": {
    "local-leads": {
      "command": "uvx",
      "args": ["local-leads-mcp"]
    }
  }
}

That's it — no credentials. Then ask your agent things like:

Find 20 restaurants in Turin with no website, verify each one, and give me a CSV of the confirmed ones with a phone number.

Optional environment variables

Tools

Discovery (OpenStreetMap — no key)

• findbusinesses(area, category, websitefilter, phoneprefix, requirephone, limit) — businesses in a city/district, filtered by website presence. ~35 friendly categories plus any raw OSM key=value tag.
• list_categories() — the category → OSM tag map.

Verification (no key)

• verifywebsite(domainorurl) — verdicts: liveownsite, notownsite, domainexistsnosite, nowebsitefound; includes per-URL evidence.
• check_mx(domain) — email deliverability pre-check via DNS-over-HTTPS.

Qualification (no key; PageSpeed optional)

• score_website(url) — 0–100 weak-site score with named issues + CMS/tech detection (WordPress, Wix, Shopify, …).

Confirmation (needs a search key)

• confirmnowebsite(business_name, city) — the final word on "really no website?", classifying search results into own-site candidates vs listings/socials.

Export

• exportleads(leadsjson, format) — CSV, JSON or Markdown table.

Ethics & fair use

Shortened. The full README is on GitHub.