# LeadMerlin

> LeadMerlin is a freemium MCP server for sales and crm. Local business leads with owner names and checked emails as JSON, with credit caps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://leadmerlin.com/for-agents/
- **Repository:** https://github.com/halberdllc/leadmerlin-mcp
- **MCP Registry name:** com.leadmerlin/leadmerlin
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-14

## About

LeadMerlin turns a niche and a city into enriched business records: Google Maps listings, owner names, checked emails, phone line types, tech stack and website text. A search returns a job that the agent polls until it completes or fails, then reads the results.

The design leans on guardrails for autonomous runs. A max_leads value is a hard limit on charges, a low balance enriches the top-ranked matches and reports the rest as over_budget_count, and running out of credits returns HTTP 402 so an agent knows to stop. Every endpoint has a /v2/demo mirror with fixture data for learning the flow without credits.

Nine tools are named: find_locations, suggest_keywords, start_search, get_job, get_results, enrich_domains, get_usage, plus check_website_tech and find_website_emails which need no key. Usage costs one credit per enriched lead, with failures refunded.

## Features

- **Enriched lead data:** Owner names, checked emails, phone line types and site tech.
- **Hard run budget:** max_leads caps what a search can charge.
- **Clear end states:** Jobs finish as completed or failed with a message.
- **Demo mode:** Fixture-backed endpoints cost no credits.
- **Domain enrichment:** enrich_domains takes domains you already have.
- **Agent skill:** A skill file works in Claude Code, Cursor and Codex.

## Good for

- Build a prospect list of plumbers in Austin
- Export CRM-ready CSV from a plain-English request
- Filter by reviews, tech stack or verified email
- Enrich a list of domains

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http leadmerlin https://api.leadmerlin.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.leadmerlin.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "leadmerlin": {
      "url": "https://api.leadmerlin.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "leadmerlin": {
      "type": "http",
      "url": "https://api.leadmerlin.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "leadmerlin": {
      "serverUrl": "https://api.leadmerlin.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "leadmerlin": {
      "type": "http",
      "url": "https://api.leadmerlin.com/mcp"
    }
  }
}
```

## Tools

- `find_locations`: Look up location codes for a city, county, state or country (free). Use the returned location_code in start_search.
- `suggest_keywords`: Turn a niche into matching Google business categories and sharper search keywords (free). Helps avoid off-niche results.
- `start_search`: Start an async search for local businesses by keyword in up to 5 locations, then enrich each one. Spends 1 credit per business with a website (website-less and off-niche listings are free). Returns a job_id; poll get_job. Call once per search: every call starts a new paid job.
- `get_job`: Status and counts for a search or enrichment job (queued, running, completed, failed, cancelled). Poll every ~5 seconds.
- `get_results`: Enriched businesses for a job, paginated. Pass next_cursor from the previous page to continue.
- `enrich_domains`: Enrich up to 100 businesses you already have, by website domain: owner name, checked emails, phone line type, tech. Spends 1 credit per domain (recently enriched domains are free). Returns a job_id.
- `get_usage`: Current plan, credit balance and phone line-type allowance.
- `check_website_tech`: Free: detect the CMS, analytics, ad pixels, chat and booking tools a single website runs.
- `find_website_emails`: Free: find the email addresses published on one website (homepage plus up to 4 contact/about/team pages), with the page each was found on, role-based/free-provider flags and an MX check. Limited per day; use start_search or enrich_domains for lists.

## FAQ

### Is there a free trial?

100 free leads with no card, and demo endpoints that need no key.

### What does a lead cost?

One credit per enriched lead; failures are refunded.

### Which tools need no key?

check_website_tech and find_website_emails.

### What auth is used?

An x-api-key header with a key starting lm_.

### Is LeadMerlin free?

LeadMerlin has a free plan, with paid plans for more usage or features.

### How do I add LeadMerlin to Claude Code?

Run this command in your terminal: claude mcp add --transport http leadmerlin https://api.leadmerlin.com/mcp

### What are the best alternatives to LeadMerlin?

The closest alternatives to LeadMerlin are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/leadmerlin
