Leadfuze Mcp Server

LeadFuze Enrichment MCP Server

Description

Enable Claude to be your everyday sales prospector. Enrich contacts and companies with verified business data directly from Claude and other MCP-compatible AI agents. Get detailed person and company information including emails, phone numbers, job titles, company details, and social profiles.

Features

• Email Enrichment: Look up detailed person and company data using an email address
• LinkedIn Enrichment: Look up detailed person and company data using a LinkedIn profile URL
• Email Validation: Verify if an email address is deliverable, check format validity, and assess risk level
• Rich Data: Returns verified business emails, phone numbers, job titles, company info, and social profiles
• No Match = No Charge: Enrichment credits are only consumed when a profile match is found

Getting Started

1. Visit LeadFuze Console to create an account
2. Your API key is automatically created on account setup
3. Find your API key on the API Keys page (starts with lfz_)
4. Configure the MCP server with your API key (see Configuration below)

Configuration

Just copy/paste the config below with your API key. No installation required.

Claude.ai

Connect to the hosted MCP server at https://mcp.leadfuze.com/mcp and enter your API key when prompted.

VS Code / Cursor

Add the following to your mcp.json file (usually at ~/.cursor/mcp.json or ~/.vscode/mcp.json):

{
  "mcpServers": {
    "leadfuze": {
      "url": "https://mcp.leadfuze.com/mcp",
      "headers": {
        "Authorization": "Bearer lfz_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "leadfuze": {
      "url": "https://mcp.leadfuze.com/mcp",
      "headers": {
        "Authorization": "Bearer lfz_your_api_key_here"
      }
    }
  }
}

Replace lfz_your_api_key_here with your actual API key from the LeadFuze console.

Rate Limits

Endpoint	Rate Limit
Enrichment (Email/LinkedIn)	10,000 requests/minute
Email Validation	20,000 requests/minute

Need higher limits? Contact us at [email protected]

Examples

Example 1: Email Enrichment (Match Found)

User prompt: "Look up the contact information for [email protected]"

What happens:

• Server searches LeadFuze database by email
• Returns person profile with job title, company, location
• Includes company details (industry, size, revenue)
• Returns social profile links
• One credit consumed for successful match

Example response:

Found: Jane Doe
- Email: [email protected] (Valid)
- Title: Medical Assistant at Example Health Inc
- Location: Phoenix, AZ
- LinkedIn: linkedin.com/in/jane-doe-example

Company: Example Health Inc
- Industry: Hospitals And Health Care
- Size: 1001-5000 employees
- Revenue: $250M - $500M

Example 2: LinkedIn Enrichment (Match Found)

User prompt: "Get contact details for linkedin.com/in/johndoe-ceo"

What happens:

• Server searches LeadFuze database by LinkedIn URL
• Returns person profile with verified business email
• Includes company details and contact information
• Returns additional social profiles if available
• One credit consumed for successful match

Example response:

Found: John Doe
- Email: [email protected] (Valid)
- Title: CEO at Acme Corporation
- Location: San Francisco, CA
- Phone: +1-555-123-4567

Company: Acme Corporation
- Industry: Software Development
- Size: 51-200 employees
- Revenue: $10M - $50M

Example 3: No Match Found (No Credit Consumed)

User prompt: "Look up [email protected]"

What happens:

• Server searches LeadFuze database
• No matching profile found in database
• Returns "no match" response
• No credit consumed - you only pay for successful matches

Example response:

No match found for: [email protected]

No credits were consumed for this lookup.
Try searching with a different email or LinkedIn URL.

Example 4: Email Validation

User prompt: "Validate the email [email protected]"

What happens:

• Server checks if the email format is valid
• Verifies the domain exists and has mail servers
• Tests deliverability via SMTP
• Assesses risk level (low, medium, high)
• One credit consumed for validation

Example response:

Email: [email protected]
Status: RISKY
Risk Level: medium

Validation Details:
- Valid Format: Yes
- Deliverable: Yes
- Host Exists: Yes
- Catch-All: Yes
- Full Inbox: No

Email Info:
- Username: john
- Domain: stripe.com

Credits Used: 1 | Remaining: 99

Privacy Policy

See our privacy policy: https://www.leadfuze.com/privacy

Support

• Email: [email protected]
• Documentation: https://www.leadfuze.com/api-docs/

---

Self-Hosting & Development

Most users don't need this section - the Configuration section above connects you to LeadFuze's hosted server.

This section is for:

• Enterprise users who need to run the server on their own infrastructure (security/compliance requirements)
• Developers contributing to this open-source project
• Offline usage where you can't connect to mcp.leadfuze.com

Installation

npm install
npm run build

Running Locally

stdio mode (for Claude Desktop, Claude Code, MCP Inspector):

LEADFUZE_API_KEY=lfz_your_key node dist/index.js

With MCP Inspector:

LEADFUZE_API_KEY=lfz_your_key npx @modelcontextprotocol/inspector node dist/index.js

Running as HTTP Server

HTTP mode (for remote deployments):

LEADFUZE_API_KEY=lfz_your_key node dist/index.js --http --port 3000

This starts an HTTP server with:

• MCP endpoint: http://localhost:3000/mcp
• Health check: http://localhost:3000/health

For production, deploy behind a reverse proxy (nginx) with TLS.