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
websitetag proves nothing.verify_websitechecks apex and www and redirects (an apex domain that doesn't resolve while the site lives happily onwww.is a classic false "no website"), andconfirm_no_websiteuses 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 asnot_own_site, not as "has a website". - Emails that bounce.
check_mxpredicts deliverability before you ever write to a lead (no MX = guaranteed bounce; PEC-only domains are flagged). - "The site is bad" needs evidence.
score_websitereturns 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
| Variable | Enables |
|---|---|
BRAVE_API_KEY |
confirm_no_website via Brave Search API |
GOOGLE_CSE_API_KEY + GOOGLE_CSE_CX |
confirm_no_website via Google Programmable Search |
PAGESPEED_API_KEY |
Lighthouse scores inside score_website |
Tools
Discovery (OpenStreetMap — no key)
find_businesses(area, category, website_filter, phone_prefix, require_phone, limit)— businesses in a city/district, filtered by website presence. ~35 friendly categories plus any raw OSMkey=valuetag.list_categories()— the category → OSM tag map.
Verification (no key)
verify_website(domain_or_url)— verdicts:live_own_site,not_own_site,domain_exists_no_site,no_website_found; 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)
confirm_no_website(business_name, city)— the final word on "really no website?", classifying search results into own-site candidates vs listings/socials.
Export
export_leads(leads_json, format)— CSV, JSON or Markdown table.
Ethics & fair use
- Data sources are public: OpenStreetMap (© OSM contributors, ODbL), public DNS, and the businesses' own public pages.
- OSM requests are rate-limited locally (min 1 s between calls) and carry a descriptive User-Agent, per the Nominatim and Overpass usage policies. For heavy workloads, run your own Overpass instance.
- This server discovers and verifies — it does not scrape personal emails and it does not send anything. How you contact a business is on you: follow your local rules (GDPR and friends).
See also
seo-stack-mcp — the same idea for SEO data: Google Search Console, GA4, Bing Webmaster and Microsoft Clarity in one MCP server. Prospect with local-leads, then monitor the sites you build with seo-stack.
License
MIT.
Built by Raffaele Nocera — web consulting for local businesses. If this tool helps you win a client, I'd love to hear about it.
Metadata
Release files for local-leads-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| local_leads_mcp-0.1.1.tar.gz | 16.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| local_leads_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.4 kB
Release files / local_leads_mcp-0.1.1.tar.gz
| Download URL | local_leads_mcp-0.1.1.tar.gz |
|---|---|
| Size | 16.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
477a13bb42338a5057ff7fee71c29f3083f68b863e53690452ac1bcf0d731bcc
|
|
BLAKE2b-256 checksum How to use checksums |
cca6b81dba0329fbf5624df7ab7a65acf3c205487c60c438eadb4b23337396b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / local_leads_mcp-0.1.1-py3-none-any.whl
| Download URL | local_leads_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 21.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df501689b7169f9307a2208a7c508fc506523ea8879944b41d1f359dd26798a0
|
|
BLAKE2b-256 checksum How to use checksums |
83ee963292904d284275ec0b0c9b1d3b8624cf4a867e285eca8660582dd92703
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|