Job Lead Converter

An intelligent Model Context Protocol (MCP) server that transforms job postings into qualified sales leads. This powerful tool automates the process of finding hiring companies, enriching their data, and identifying decision-makers and their contact information.

🎯 What does it do?

Job Lead Converter provides a comprehensive Master Pipeline and modular tools designed to stream-line lead generation:

1. Job Searching: Finds companies actively hiring for specific roles in desired locations.
2. Company Enrichment: Gathers detailed data on the hiring companies (industry, size, tech stack, etc.).
3. Lead Identification: Discovers the names, titles, and email addresses of key decision-makers.

By combining these steps, this MCP server hands you highly qualified leads without manual prospecting.

🛠️ Features (MCP Tools)

• search_jobs(query, location, num_pages): Uses the JSearch API via RapidAPI to hunt down active job postings.
• enrich_company(domain): Uses the TechnologyChecker API to get a deep dive on a company's profile.
• find_lead_email(domain, company_name): Employs Hunter.io to precisely locate and verify top-level decision-maker contact details.
• generate_sales_leads(job_query, location): The Master Pipeline! Connects the three tools above into one seamless flow. Pass it a query (e.g., "Software Engineer"), and watch it output fully qualified leads ready for outreach.

⚙️ Prerequisites

You need API keys from three different providers to tap into the full potential of this server:

1. RapidAPI (Specifically for the JSearch API)
2. TechnologyChecker
3. Hunter.io

🚀 Installation & Setup

1. Clone the repository:

   git clone https://github.com/adeeljames/job-lead-converter-mcp.git
   cd job-lead-converter-mcp
   

2. Set up a virtual environment (Recommended):

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
   

3. Install the dependencies:

   # If you have uv installed (recommended)
   uv pip install -r requirements.txt
   
   # Or using standard pip
   pip install -r requirements.txt
   

4. Environment Variables: Create a .env file in the root directory (this file is ignored by Git to keep your keys safe):

   RAPIDAPI_KEY="your_rapidapi_key_here"
   TECHNOLOGY_CHECKER_KEY="your_tech_checker_key_here"
   HUNTER_API_KEY="your_hunter_api_key_here"
   

🎮 Usage

You can launch the MCP server directly by running:

python server.py

🔌 Connecting to an MCP Client (e.g., Claude Desktop)

To use this with an MCP-compatible client like Claude for Desktop, edit your config file (typically claude_desktop_config.json) and add the following integration under mcpServers:

{
  "mcpServers": {
    "job-lead-converter": {
      "command": "/path/to/your/virtual/environment/bin/python",
      "args": ["/path/to/job-lead-converter-mcp/server.py"]
    }
  }
}

Note: Ensure the absolute paths reflect your local installation.

🤝 Contributing

Contributions are welcome! If you've got ideas on how to improve the accuracy of the leads, optimize API calls, or add new data sources, feel free to open a Pull Request.

📝 License

This project is open-source and available under the MIT License.