{
  "markdown": "# LeadPipe MCP\n\n**AI-powered lead qualification engine for the Model Context Protocol**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6.svg)](https://www.typescriptlang.org/)\n[![MCP](https://img.shields.io/badge/MCP-1.29-2A9D8F.svg)](https://modelcontextprotocol.io/)\n\nLeadPipe ingests leads from any source, enriches them with company data, scores them 0-100 using configurable AI rules, and exports qualified leads to your CRM — all through the MCP protocol.\n\n---\n\n## Features\n\n- **Lead ingestion** from webhooks, forms, APIs, or CSV — single or batch (up to 100)\n- **Auto-enrichment** with company data: industry, size, country, tech stack (via Hunter.io or domain heuristics)\n- **AI scoring engine** (0-100) with 6 weighted dimensions + custom rules\n- **CRM export** to HubSpot, Pipedrive, CSV, or JSON\n- **ICP pre-qualification** to filter leads on freemail/title/country/tech-stack *before* spending a single enrichment credit\n- **Pipeline analytics** with real-time stats, score distribution, conversion rates\n- **Configurable** scoring weights, high-value titles/industries, custom rules\n- **10 MCP tools** + **3 MCP resources** covering the full lead lifecycle\n\n---\n\n## Quick Start\n\n### Install from MCPize Marketplace\n\n1. Search for **LeadPipe MCP** on [mcpize.com](https://mcpize.com)\n2. Click **Install** and select your subscription tier\n3. Tools and resources are automatically available in any MCP-compatible client (Cursor, VS Code, etc.)\n\n### Build from Source\n\n```bash\ngit clone https://github.com/enzoemir1/leadpipe-mcp.git\ncd leadpipe-mcp\nnpm ci\nnpm run build\n```\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadpipe\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/leadpipe-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n---\n\n## Tools\n\n### lead_demo_seed\n\nSeed the pipeline with a realistic demo dataset — 14 leads across 5 archetypes (hot decision-makers, warm mid-level, cold junior/small-co, raw unenriched, and disqualified) — so every downstream tool returns meaningful output without any API keys. Safe to call multiple times; each call appends a fresh batch with new UUIDs.\n\n```json\n{}\n```\n\nReturns: counts by status plus `sample_lead_ids` you can feed into `lead_enrich`, `lead_score`, or `lead_export`.\n\n### lead_qualify\n\nFilter leads against your Ideal Customer Profile **before** spending any enrichment credits. Uses only locally-available signals — email domain, job title, country, industry, company size, tech stack — so nothing is charged to Hunter.io, HubSpot, or Pipedrive.\n\n```json\n{\n  \"criteria\": {\n    \"reject_freemail\": true,\n    \"required_title_keywords\": [\"vp\", \"director\", \"head\", \"founder\"],\n    \"target_countries\": [\"US\", \"CA\", \"GB\"],\n    \"min_company_size\": \"11-50\",\n    \"required_tech_stack\": [\"shopify\"]\n  },\n  \"auto_disqualify\": true\n}\n```\n\nReturns per-lead qualified/rejected decisions with reasons and an estimated credit savings figure.\n\n> **Pairs well with platform detection tools.** If you chain a tool like [Detecto](https://github.com/) (`detect_platform`) *before* `lead_qualify`, the detected tech stack populates `company.tech_stack`, and `required_tech_stack` can drop wrong-platform leads before they ever reach enrichment or scoring.\n\n### lead_ingest\n\nAdd a single lead to the pipeline.\n\n```json\n{\n  \"email\": \"jane@acme.com\",\n  \"first_name\": \"Jane\",\n  \"last_name\": \"Smith\",\n  \"job_title\": \"VP of Engineering\",\n  \"company_name\": \"Acme Corp\",\n  \"company_domain\": \"acme.com\",\n  \"source\": \"website_form\",\n  \"tags\": [\"demo-request\"]\n}\n```\n\n### lead_batch_ingest\n\nAdd 1-100 leads at once. Duplicates are automatically skipped.\n\n```json\n{\n  \"leads\": [\n    { \"email\": \"lead1@corp.com\", \"job_title\": \"CEO\" },\n    { \"email\": \"lead2@startup.io\", \"job_title\": \"CTO\" }\n  ]\n}\n```\n\n### lead_enrich\n\nEnrich a lead with company data using the email domain.\n\n```json\n{ \"lead_id\": \"uuid-of-lead\" }\n```\n\nReturns: company name, industry, size, country, tech stack, LinkedIn URL.\n\n### lead_score\n\nCalculate a qualification score (0-100). Leads scoring 60+ are marked **qualified**.\n\n```json\n{ \"lead_id\": \"uuid-of-lead\" }\n```\n\nReturns score + detailed breakdown across all 6 dimensions.\n\n### lead_search\n\nSearch and filter leads with pagination.\n\n```json\n{\n  \"query\": \"acme\",\n  \"status\": \"qualified\",\n  \"min_score\": 60,\n  \"limit\": 20,\n  \"offset\": 0\n}\n```\n\n### lead_export\n\nExport leads to CRM or file format.\n\n```json\n{\n  \"target\": \"hubspot\",\n  \"min_score\": 60\n}\n```\n\nTargets: `hubspot`, `pipedrive`, `csv`, `json`\n\n> Google Sheets export is on the roadmap. Currently returns Sheets-ready formatted data.\n\n### pipeline_stats\n\nGet pipeline analytics. No input required.\n\nReturns: total leads, status/source breakdown, average score, score distribution, qualified rate, leads today/week/month.\n\n### config_scoring\n\nView or update scoring configuration.\n\n```json\n{\n  \"job_title_weight\": 0.30,\n  \"high_value_titles\": [\"ceo\", \"cto\", \"vp\", \"founder\"],\n  \"custom_rules\": [\n    {\n      \"field\": \"company_industry\",\n      \"operator\": \"equals\",\n      \"value\": \"fintech\",\n      \"points\": 15,\n      \"description\": \"Bonus for fintech companies\"\n    }\n  ]\n}\n```\n\n---\n\n## Resources\n\n| Resource | Description |\n|----------|-------------|\n| `leads://recent` | The 50 most recently added leads |\n| `leads://pipeline` | Pipeline summary with status counts, scores, conversion rates |\n| `leads://config` | Current scoring engine configuration |\n\n---\n\n## Scoring Engine\n\nLeads are scored 0-100 using a weighted average of 6 dimensions:\n\n| Dimension | Default Weight | How It Works |\n|-----------|---------------|--------------|\n| Job Title | 25% | C-level/Founder: 100, VP/Director: 85, Manager: 65, Senior: 50, Junior: 15 |\n| Company Size | 20% | Preferred sizes (11-50, 51-200, 201-500): 90, others scaled accordingly |\n| Industry | 20% | High-value industries (SaaS, fintech, etc.): 90, others: 40 |\n| Engagement | 15% | Phone provided, full name, tags, source type (landing page > CSV) |\n| Recency | 10% | Today: 100, last week: 75, last month: 35, 3+ months: 5 |\n| Custom Rules | 10% | User-defined rules with -50 to +50 points each |\n\n**Formula:** `score = sum(dimension_score * weight)`\n\nLeads with score >= 60 are **qualified**. Below 60 are **disqualified**.\n\n---\n\n## CRM Integration\n\n### HubSpot\n\nSet the `HUBSPOT_API_KEY` environment variable with your HubSpot private app access token.\n\n```bash\nexport HUBSPOT_API_KEY=\"pat-xxx-xxx\"\n```\n\n### Pipedrive\n\nSet the `PIPEDRIVE_API_KEY` environment variable.\n\n```bash\nexport PIPEDRIVE_API_KEY=\"xxx\"\n```\n\n### CSV / JSON\n\nNo configuration needed. Export returns data directly.\n\n---\n\n## Enrichment\n\nLeadPipe extracts the domain from the lead's email and looks up company data:\n\n1. **Hunter.io** (if `HUNTER_API_KEY` is set) — returns organization, industry, country, tech stack\n2. **Domain heuristics** — maps known domains to company data\n3. **Freemail detection** — gmail.com, yahoo.com, etc. are flagged (no company enrichment)\n\n---\n\n## Pricing\n\n| Tier | Price | Tools | Features |\n|------|-------|-------|----------|\n| Free | €0 | `lead_demo_seed`, `lead_ingest`, `lead_batch_ingest`, `lead_search`, `lead_score`, `config_scoring` | Ingest, manual scoring, ICP pre-qualification |\n| Pro | **€19** lifetime | + `lead_qualify`, `lead_enrich`, `lead_export`, `pipeline_stats` | AI scoring, Hunter.io enrichment, CRM export, pipeline analytics |\n\nOne-time **€19** lifetime license (3 machines) — no subscription. See **[Pro License](#pro-license)** below to buy and activate.\n\n---\n\n## Development\n\n```bash\nnpm run dev        # Hot reload development\nnpm run build      # Production build\nnpm test           # Run unit tests\nnpm run inspect    # Open MCP Inspector\n```\n\n---\n\n## Pro License\n\nLeadPipe ships in **Free mode** — `lead_demo_seed`, `lead_ingest`, `lead_batch_ingest`, `lead_search`, `lead_score`, and `config_scoring` are open. The following tools require a **Pro license**:\n\n- `lead_qualify` — ICP pre-filter\n- `lead_enrich` — domain knowledge-base enrichment\n- `lead_export` — HubSpot / Pipedrive / Google Sheets / CSV / JSON\n- `pipeline_stats` — portfolio analytics\n\n**Buy a Pro License (€19, lifetime, 3 machines):** https://automatiabcn.lemonsqueezy.com/buy/360565a3-2577-45e2-93dd-1548a881f456\n\nOr get the **[Indie MCP Stack Bundle](https://automatiabcn.lemonsqueezy.com/buy/55e932fd-8319-47f0-8e95-0b86a29f2617)** (€69, all 4 servers).\n\nThen activate by setting the env var:\n\n```bash\nexport LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE\n```\n\nOr in your Claude Desktop / MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadpipe-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"leadpipe-mcp-server\"],\n      \"env\": { \"LEMONSQUEEZY_LICENSE_KEY\": \"YOUR-KEY-HERE\" }\n    }\n  }\n}\n```\n\nValidation is cached locally for 24 h, so the server is fully offline-capable after the first run.\n\n---\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\nBuilt by [Automatia BCN](https://github.com/enzoemir1).\n",
  "bytes": 9007,
  "sha": "2b9bd3220464427860e3ef6d45a99e66fb4beba986590acf2523f8ce5b0e19dc",
  "repo_slug": "enzoemir1/leadpipe-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_enzoemir1_leadpipe_mcp_8f7cf94c/readme"
}