LeadMind MCP
Exposes a REST API for the CRM, providing endpoints for health checks, lead management, statistics, auditing, and dashboard snapshots.
Includes a webhook receiver for n8n and Gmail integration to capture leads from external workflows.
Provides a Next.js frontend dashboard for visualizing leads, pipeline statistics, source breakdowns, and managing leads through a web interface.
The frontend dashboard and backend REST API are deployed on Render's free hosting tier.
Uses SQLite (WAL mode) as the persistent database layer for storing leads, history, and audit trails.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LeadMind MCPShow all hot leads and suggest next actions."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π§ LeadMind MCP β AI Lead Management CRM
Conversational AI lead management powered by the Model Context Protocol. Free-tier only β Groq LLM + SQLite. Zero paid APIs.
π Live Dashboard Β· π Backend API Β· π MCP Docs Β· π§ Claude Desktop Config
β¨ Live Demo
Try it right now β no login required. Dashboard resets every 4 hours.
Frontend Dashboard | |
Backend REST API | |
API Health Check | |
API Stats |
Related MCP server: PipeDrive MCP Server
π― What is LeadMind?
LeadMind MCP is a complete AI-powered CRM that:
Auto-classifies leads as Hot / Warm / Cold using Groq's Llama-3.3-70b
Suggests next actions for each lead (AI-powered coaching)
Tracks full history β every status change, classification, and note is audited
Works with Claude Desktop via the Model Context Protocol β manage leads conversationally
Runs on free-tier everything β Groq free API + SQLite + Render free hosting
π Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β Claude Desktop β
β (MCP Client β stdio) β
ββββββββββββββββββββββββ¬βββββββββββββββββββββββββββ
β MCP Protocol (stdio)
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β leadmind-mcp/mcp_server.py β
β MCP Server β 8 Tools + 3 Resources β
β β
β βββββββββββ ββββββββββββ βββββββββββββββββββ β
β β Groq β β Fallbackβ β Cache (5 min) β β
β β Llama ββ β Rules ββ β TTL + SQLite β β
β β 70b β β Engine β β persistent β β
β βββββββββββ ββββββββββββ βββββββββββββββββββ β
β β β
β βΌ β
β βββββββββββββββββββ β
β β SQLite (WAL) β β
β β leadmind.db β β
β ββββββββββ¬βββββββββ β
βββββββββββββββββββββββββΌβββββββββββββββββββββββββββ
β
βββββββββββββββΌββββββββββββββ
β β β
βΌ βΌ βΌ
ββββββββββββββ ββββββββββββ ββββββββββββββββ
β MCP CLI β β FastAPI β β Next.js β
β (Claude) β β REST API β β Dashboard β
β stdio β β :8000 β β (Render) β
ββββββββββββββ ββββββββββββ ββββββββββββββββπ Quick Start
Prerequisites
Python 3.12+
uv (recommended) or pip
Groq API key (free at console.groq.com) β optional, fallback works without it
1. Clone & Install
git clone https://github.com/mansisonani07/leadmind-mcp.git
cd leadmind-mcp
pip install -r requirements.txt2. Run the MCP Server (Claude Desktop)
python mcp_server.py3. Run the REST API
python api_server.py # http://localhost:80004. Run the Web Dashboard
python web_dashboard.py # http://localhost:8000 (HTML + API combined)5. Run the Next.js Frontend
cd ..
npm install
LEADMIND_BACKEND_URL=http://localhost:8000 npm run devπ€ Claude Desktop Integration
Add this to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"leadmind": {
"command": "python",
"args": ["/path/to/leadmind-mcp/mcp_server.py"],
"env": {
"GROQ_API_KEY": "gsk_your_key_here"
}
}
}
}Then ask Claude things like:
"Show me all hot leads"
"Add a new lead: Sarah Chen, sarah@acme.com, interested in enterprise plan"
"What should I do next with lead #5?"
"Classify this: We need a CRM solution, budget approved, looking to sign next week"
π MCP Tools Exposed
Tool | Description |
| List leads, filter by status |
| AI classification β Hot/Warm/Cold with reasoning |
| Add a lead + auto-classify on insert |
| Manual status override + history log |
| Pipeline aggregate statistics |
| Full event timeline per lead |
| AI-recommended next step for a lead |
| CSV parse + batch classify |
MCP Resources
URI | Description |
| Live pipeline snapshot |
| Recent tool-call audit log |
MCP Prompts
Name | Description |
| Structured weekly summary |
π‘ REST API Endpoints
Method | Endpoint | Description |
|
| Health check + service info |
|
| Pipeline stats + Groq usage |
|
| List leads (optional status filter) |
|
| Single lead + history timeline |
|
| Add a lead (auto-classifies) |
|
| Update lead status |
|
| AI next-action suggestion |
|
| Bulk import from CSV |
|
| Recent tool-call audit log |
|
| Full dashboard snapshot |
|
| Reset database to seed data |
Try it:
curl https://leadmind-mcp-1.onrender.com/health
curl https://leadmind-mcp-1.onrender.com/leads?status=Hot
curl https://leadmind-mcp-1.onrender.com/statsβ‘ Reliability Engineering
LeadMind is built with production-grade resilience:
Feature | Description |
π Three-tier classification | Cache β Groq LLM β Rule-based fallback |
π¦ TTL Cache | 5-minute cache avoids redundant Groq calls |
π‘οΈ Rate-limit handler | Graceful degradation on Groq 429 errors |
π Auto-restart | Dashboard auto-restarts Python if it crashes |
ποΈ SQLite WAL mode | Concurrent reads + atomic writes |
π Demo auto-reset | Fresh data every 4 hours (configurable) |
π Audit logging | Every tool call tracked with duration |
π¨ Dashboard Features
6 KPI cards β Total leads, Hot leads, Conversion rate, Avg response, Groq calls, Sources
Pipeline distribution β Visual bar chart by status
Source breakdown β Leads by acquisition channel
Full leads table β Search, filter by status, sort
Lead detail drawer β Status update, AI next action, message, timeline
Add lead modal β Auto-classifies with AI on submit
Audit log β Every tool call with Groq/fallback/cache flags
MCP primitives panel β Shows all exposed tools, resources, and prompts
Dark mode β Toggle between light and dark themes
π Environment Variables
Variable | Default | Description |
| β | Free Groq API key |
|
| Auto-reset DB to seed data |
|
| Reset interval (4 hours) |
|
| Enable API key auth |
| β | API secret key when auth enabled |
|
| Backend listen port |
| β | Backend URL for Next.js frontend |
π Project Structure
leadmind-mcp/
βββ mcp_server.py # MCP server (stdio) β used by Claude Desktop
βββ api_server.py # REST API server β used by Next.js frontend
βββ web_dashboard.py # Self-contained HTML dashboard + API
βββ tools.py # MCP tool implementations
βββ db.py # SQLite database layer
βββ groq_classifier.py # Groq LLM classification + caching
βββ fallback_classifier.py # Rule-based fallback classifier
βββ seed_data.py # Demo seed data (22 leads)
βββ config.py # Configuration from env vars
βββ cache.py # TTL cache implementation
βββ webhook_receiver.py # n8n / Gmail webhook receiver
βββ requirements.txt # Python dependencies
βββ claude_desktop_config.example.json
src/ # Next.js frontend (React + TypeScript)
βββ app/
β βββ page.tsx # Dashboard entry point
β βββ api/leadmind/[...path]/route.ts # API proxy
β βββ layout.tsx # Root layout with fonts + toasters
βββ components/leadmind/
β βββ DashboardPage.tsx # Main dashboard orchestrator
β βββ Header.tsx # App header with branding
β βββ StatsGrid.tsx # KPI cards + charts
β βββ LeadsTable.tsx # Searchable leads table
β βββ LeadDetailDrawer.tsx # Slide-out lead detail
β βββ AddLeadDialog.tsx # Add lead modal
β βββ AuditPanel.tsx # Tool call audit log
β βββ McpPrimitivesPanel.tsx # MCP tools/resources display
βββ lib/
β βββ leadmind-api.ts # API client (fetch wrapper)
β βββ leadmind-ui.ts # Status colors, formatters
βββ components/ui/ # shadcn/ui componentsπ’ Deployment
Render (Free Tier)
Backend: render.com β New Web Service
Build:
pip install -r requirements.txtStart:
python api_server.pySet
GROQ_API_KEYenv var
Frontend: render.com β New Web Service
Build:
npm install && npm run buildStart:
next start -p $PORTSet
NEXT_PUBLIC_LEADMIND_BACKEND_URL=https://your-backend.onrender.com
π License
MIT License β free for personal and commercial use.
π Credits
Groq β Free LLM inference (Llama-3.3-70b)
Model Context Protocol by Anthropic
FastAPI β Python web framework
Next.js β React framework
shadcn/ui β UI component library
Built with β€οΈ by mansisonani07
β If you find this useful, give it a star!
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityAmaintenanceMCP server that enables AI agents to discover and qualify B2B leads from Leadbay's knowledge base, with tools for lead research, enrichment, and outreach logging.MIT
- Alicense-qualityCmaintenanceA comprehensive MCP server for the Pipedrive CRM API, enabling AI assistants to read, write, and analyze CRM data conversationally through 100 tools including performance reporting and loss analysis.2158MIT
- AlicenseCqualityCmaintenanceAn MCP server that gives AI agents full access to Follow Up Boss CRM via natural language, enabling CRUD operations on people, deals, appointments, and more through 160 tools.100101Elastic 2.0
- Alicense-qualityBmaintenanceMCP server for qualifying and responding to inbound leads in seconds using a multi-agent AI pipeline.1MIT
Related MCP Connectors
MCP server for LeadDelta β manage LinkedIn connections and CRM data via AI assistants.
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
LeadConnector / GoHighLevel MCP Pack β wraps the GoHighLevel CRM for AI agents.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mansisonani07/leadmind-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server