Lead Qualifier

🚀 🤖 MCP (Lead Qualification) Tool

A lightweight MCP tool that leverages ChatGPT to qualify leads through the BANT mechanism (Budget, Authority, Need, Timeline) and guides users to input relevant information step by step.

🚀 Quick Start

This MCP tool is designed to help you qualify leads efficiently. It uses ChatGPT to extract and score lead qualification information based on the BANT framework.

✨ Features

• 🧠 Extract and score lead qualification information based on Large Language Models (LLMs).
• 💬 Use a conversational flow, asking for one field per round.
• 💾 Track sessions quickly in memory, and can be extended to support Redis.
• 🔌 Compatible with Dify / Cursor via MCP (sse).

📦 Installation

Step 1: Configure the API Key

Configure your ChatGPT API key in your .env file.

OPENAI_API_KEY=1234

Step 2: Start the NodeJS Server

Start your NodeJS server, which will serve as your MCP server.

npm install
npm start

Step 3: (Optional) Expose Your Server with ngrok

You can use ngrok to expose your server.

ngrok http 3001

Step 4: Dify Agent Policy Configuration Example

Here is an example of Dify Agent policy configuration:

{
  "lead_qualification": {
    "transport": "sse",
    "url": "https://24c3-172-235-53-238.ngrok-free.app/sse",
    "headers": {},
    "timeout": 50,
    "sse_read_timeout": 50
  }
}

💻 Usage Examples

Basic Usage

Tool Name: lead-qualifier
Input:

{
  "sessionId": "abc123",
  "message": "Our budget is $1000 per month"
}

Output:

{
  content: [
    {
      type: "text",
      text: "Are you the main person evaluating this tool, or are there others involved in the decision-making?"
    }
  ],
  isError: false
}

Session:

{
  "qualificationMap": {
    "budget": "$1000 per month",
    "authority": "",
    "need": "",
    "timeline": ""
  },
  "scoreMap": {
    "budget": 30,
    "authority": 0,
    "need": 0,
    "timeline": 0
  },
  "totalScore": 30,
  "nextField": "authority",
  "lastPromptedField": "authority",
  "lastPromptedQuestion": "Are you the main person evaluating this tool, or are there others involved in the decision-making?"
}