# 🚀 Job Lead Converter MCP

![Job Lead Converter](https://img.shields.io/badge/MCP-Server-blue?style=for-the-badge&logo="python")
![Python](https://img.shields.io/badge/Python-3.9%2B-green?style=for-the-badge&logo="python")

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](https://rapidapi.com/letscrape-6bRBa3QG1q/api/jsearch) via RapidAPI to hunt down active job postings.
* **`enrich_company(domain)`**: Uses the [TechnologyChecker API](https://technologychecker.io/) to get a deep dive on a company's profile.
* **`find_lead_email(domain, company_name)`**: Employs [Hunter.io](https://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](https://rapidapi.com/)** (Specifically for the JSearch API)
2. **[TechnologyChecker](https://technologychecker.io/)**
3. **[Hunter.io](https://hunter.io/)**

## 🚀 Installation & Setup

1. **Clone the repository:**
   ```bash
   git clone https://github.com/adeeljames/job-lead-converter-mcp.git
   cd job-lead-converter-mcp
   ```

2. **Set up a virtual environment (Recommended):**
   ```bash
   python -m venv .venv
   source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
   ```

3. **Install the dependencies:**
   ```bash
   # 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):
   ```env
   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:
```bash
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`:

```json
{
  "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.