About LeadMerlin
LeadMerlin is a lead research MCP server for finding local businesses by niche and location. It enriches results with owner names, checked email addresses, phone line types and website technology for sales and prospecting workflows.
Key features
- 01Find businesses by niche and locations
- 02Suggest categories and refined keywords
- 03Enrich leads with owner and contact details
- 04Check email addresses and phone line types
- 05Identify website technologies
- 06Track searches and retrieve paginated results
Use cases
- 01Build a prospect list for a city and industry
- 02Find owner names and checked emails for leads
- 03Enrich existing domains with business details
- 04Inspect a prospect’s website technology
MCP support
Provides lead search, enrichment, job tracking, usage and website technology tools to MCP clients via a hosted Streamable HTTP server, with a local stdio bridge also available. Most tools require a LeadMerlin API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.leadmerlin.com/mcpclaude mcp add --transport http com-leadmerlin-leadmerlin https://api.leadmerlin.com/mcp{"mcpServers":{"com-leadmerlin-leadmerlin":{"type":"http","url":"https://api.leadmerlin.com/mcp"}}}Open in Cursor{"servers":{"com-leadmerlin-leadmerlin":{"type":"http","url":"https://api.leadmerlin.com/mcp"}}}Open in VS Code{"mcpServers":{"com-leadmerlin-leadmerlin":{"type":"http","url":"https://api.leadmerlin.com/mcp"}}}{"mcpServers":{"com-leadmerlin-leadmerlin":{"serverUrl":"https://api.leadmerlin.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.leadmerlin.com/mcpAuth requiredTools
Details
From the project READMELeadMerlin MCP server
Find local businesses by niche and city from any MCP client (Claude, Cursor, VS Code, n8n…), with each one enriched: owner name, emails checked against the mail server, phone line type (mobile / landline / VoIP) and the tech its website runs.
- Remote server (no install):
https://api.leadmerlin.com/mcp(Streamable HTTP) - Local stdio bridge:
npx -y github:HalberdLLC/leadmerlin-mcp(Node 18+, no dependencies) - Auth: your LeadMerlin API key (
lm_...) in thex-api-keyheader, orAuthorization: Bearer lm_.... Sign up for 100 free leads, no card.
Tools
| Tool | What it does | Cost |
|---|---|---|
find_locations | City / state / country → location_code | free |
suggest_keywords | Niche → Google categories and sharper keywords | free |
start_search | Search a niche in up to 5 locations, enrich every business. Returns a job_id | 1 credit per business with a website |
get_job | Job status and counts (poll every ~5 s) | free |
get_results | Enriched businesses, paginated | free |
enrich_domains | Enrich up to 100 domains you already have | 1 credit per domain (recently enriched ones are free) |
get_usage | Plan, credit balance, phone lookup allowance | free |
check_website_tech | CMS, analytics, ad pixels, chat and booking tools on one site | free, no key needed |
Businesses without a website and off-niche listings (a bar that matched "plumber" by coincidence) are never charged. Always pass max_leads to start_search.
Setup
Claude Code
claude mcp add --transport http leadmerlin https://api.leadmerlin.com/mcp --header "x-api-key: lm_your_key"
Cursor / VS Code / Windsurf (remote)
{
"mcpServers": {
"leadmerlin": {
"url": "https://api.leadmerlin.com/mcp",
"headers": { "x-api-key": "lm_your_key" }
}
}
}
Claude Desktop and other stdio-only clients
{
"mcpServers": {
"leadmerlin": {
"command": "npx",
"args": ["-y", "github:HalberdLLC/leadmerlin-mcp"],
"env": { "LEADMERLIN_API_KEY": "lm_your_key" }
}
}
}
n8n
Use the MCP Client Tool node with endpoint https://api.leadmerlin.com/mcp, transport HTTP Streamable, and header auth x-api-key.
Example
Find 25 roofing contractors in Denver, CO with an owner name and a verified email, and give me a table.
The agent calls find_locations("Denver") → start_search({ keyword: "roofing contractor", location_codes: [1014485], max_leads: 25 }) → polls get_job → get_results.
Links
- Docs and REST API: https://leadmerlin.com/docs/
- For agents (skill file, guardrails): https://leadmerlin.com/for-agents/
- OpenAPI: https://api.leadmerlin.com/api/v2/openapi.json
- Claude skill: https://github.com/HalberdLLC/leadmerlin-skill
MIT licensed. The bridge only forwards JSON-RPC to the hosted server; your key never leaves the request header.
Comments
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.