{"_id":"@bingeljell/lead-gen-mcp","_rev":"2-d911c81fb445332d362cdf55d91f873b","name":"@bingeljell/lead-gen-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@bingeljell/lead-gen-mcp","version":"0.1.0","keywords":["mcp","lead-generation","ai-agent","claude","playwright"],"license":"MIT","_id":"@bingeljell/lead-gen-mcp@0.1.0","maintainers":[{"name":"bingeljell","email":"nikhil.shahane@gmail.com"}],"bin":{"lead-gen-mcp":"dist/server.js"},"dist":{"shasum":"9e2f153884c3323f612f3929cebd2063b34e24e5","tarball":"https://registry.npmjs.org/@bingeljell/lead-gen-mcp/-/lead-gen-mcp-0.1.0.tgz","fileCount":23,"integrity":"sha512-0sA6hiZT/J6z8W3/m++7YoVSocAR42F3pRwyxIgm04KP0U+VIz3yH3mSXH9MjLoPE49j4gWYGCk69hhNZvFCmw==","signatures":[{"sig":"MEUCIQCZgTZZ9O9B6o5FamY+Cf/wiReKfMWVsif2broqKOXvPgIgWgtX0kFP5yIKJlTsFRKu8mgwjJ0KaJc7RjjYES0A3bw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64692},"main":"dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=20"},"gitHead":"f4478b80210448d351e592e3cf77d2f3ad669461","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/server.js","prepare":"playwright install chromium"},"_npmUser":{"name":"bingeljell","email":"nikhil.shahane@gmail.com"},"_npmVersion":"11.11.0","description":"MCP server for AI-assisted B2B lead generation — discover, extract, score, and export company leads","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^3.24.0","playwright":"^1.50.0","@anthropic-ai/sdk":"^0.39.0","@modelcontextprotocol/sdk":"^1.10.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/lead-gen-mcp_0.1.0_1774598587245_0.13739759402387342","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bingeljell/lead-gen-mcp","version":"0.1.1","description":"MCP server for AI-assisted B2B lead generation — discover, extract, score, and export company leads","type":"module","main":"dist/server.js","bin":{"lead-gen-mcp":"dist/server.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/server.js","setup:browsers":"playwright install chromium"},"keywords":["mcp","lead-generation","ai-agent","claude","playwright"],"license":"MIT","dependencies":{"@anthropic-ai/sdk":"^0.39.0","@modelcontextprotocol/sdk":"^1.10.1","playwright":"^1.50.0","zod":"^3.24.0"},"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"engines":{"node":">=20"},"gitHead":"3bf4cc93beb5b64ee6e542ddca1cfb4ce8bdf545","types":"./dist/server.d.ts","_id":"@bingeljell/lead-gen-mcp@0.1.1","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-BiMF/6Kp7LpK0NupYALSm3GZh17eMFpVu2kEq2U80VtacdET+ARW1aEjoJglz1HM1BspqxBQGuUsQ0x7MTdWAQ==","shasum":"b459a853f2a222306396c645d9e254c0b461e164","tarball":"https://registry.npmjs.org/@bingeljell/lead-gen-mcp/-/lead-gen-mcp-0.1.1.tgz","fileCount":23,"unpackedSize":64699,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA5q1qmjIbyyWLKmyHh4V7jN1kKgH/U5IRKnfiHBqB50AiEAou7NmxkllrR85H/vOGEEY7wdZohwg9TYtT8Ij0wRPms="}]},"_npmUser":{"name":"bingeljell","email":"nikhil.shahane@gmail.com"},"directories":{},"maintainers":[{"name":"bingeljell","email":"nikhil.shahane@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/lead-gen-mcp_0.1.1_1774599034340_0.10582185364465957"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-27T08:03:07.133Z","modified":"2026-03-27T08:10:34.587Z","0.1.0":"2026-03-27T08:03:07.392Z","0.1.1":"2026-03-27T08:10:34.488Z"},"license":"MIT","keywords":["mcp","lead-generation","ai-agent","claude","playwright"],"description":"MCP server for AI-assisted B2B lead generation — discover, extract, score, and export company leads","maintainers":[{"name":"bingeljell","email":"nikhil.shahane@gmail.com"}],"readme":"# @bingeljell/lead-gen-mcp\n\nMCP server for AI-assisted B2B lead generation. Discover, extract, score, and export company leads — from any MCP-compatible agent (Claude Desktop, Cursor, Windsurf, Codex, etc.).\n\n## Context\n\n- This started as a lead pipeline inside [Alfred](https://github.com/bingeljell/alfredAI) — a personal AI agent built for outbound sales work\n- Extracted into a standalone MCP server so anyone selling to small and mid-sized businesses can use it with their agent of choice\n- Works across agents — not Claude-specific\n- **Still under active development.** See [docs/release_notes.md](docs/release_notes.md) for what's in each release\n\n## Tools\n\n| Tool | What it does |\n|------|-------------|\n| `lead_discover` | Search for companies matching a query and rank them by ICP fit. No browser required. |\n| `lead_extract` | Deep-extract a single company's name, emails, industry, and size from a URL via headless browser. |\n| `lead_generate` | Full pipeline: search → rank → extract → filter → save to CSV. |\n\n## Requirements\n\n- Node.js ≥ 20\n- A search provider — SearXNG (self-hosted), Brave API key, or nothing (falls back to DuckDuckGo automatically)\n- An LLM key (Anthropic or OpenAI) — optional but improves extraction quality\n\n## Setup\n\n### Option A — Use via npx (no clone needed)\n\nThe server runs on demand. Just configure your agent to call it with `npx`:\n\n```json\n\"command\": \"npx\",\n\"args\": [\"-y\", \"@bingeljell/lead-gen-mcp\"]\n```\n\n### Option B — Clone and build locally\n\n```bash\ngit clone https://github.com/bingeljell/lead-gen-mcp\ncd lead-gen-mcp\nnpm install\nnpx playwright install chromium   # one-time ~130MB browser download\nnpm run build\n```\n\nPoint your agent at the built file:\n\n```json\n\"command\": \"node\",\n\"args\": [\"/absolute/path/to/lead-gen-mcp/dist/server.js\"]\n```\n\n---\n\n## Agent configuration\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"lead-gen\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bingeljell/lead-gen-mcp\"],\n      \"env\": {\n        \"SEARXNG_BASE_URL\": \"http://localhost:8888\",\n        \"ANTHROPIC_API_KEY\": \"sk-ant-...\",\n        \"LEAD_GEN_OUTPUT_DIR\": \"/Users/you/leads\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The three tools appear automatically.\n\n### Cursor / Windsurf\n\nSame config format — add to your MCP settings JSON and restart the editor.\n\n### OpenAI Agents SDK (Codex)\n\n```python\nfrom agents import Agent\nfrom agents.mcp import MCPServerStdio\n\nlead_gen = MCPServerStdio(\n    command=\"npx\",\n    args=[\"-y\", \"@bingeljell/lead-gen-mcp\"],\n    env={\n        \"SEARXNG_BASE_URL\": \"http://localhost:8888\",\n        \"ANTHROPIC_API_KEY\": \"sk-ant-...\",\n        \"LEAD_GEN_OUTPUT_DIR\": \"./leads\"\n    }\n)\n\nagent = Agent(name=\"LeadResearcher\", mcp_servers=[lead_gen])\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add lead-gen \\\n  -e SEARXNG_BASE_URL=http://localhost:8888 \\\n  -e ANTHROPIC_API_KEY=sk-ant-... \\\n  -e LEAD_GEN_OUTPUT_DIR=/Users/you/leads \\\n  npx -y @bingeljell/lead-gen-mcp\n```\n\n---\n\n## Environment variables\n\n```bash\n# Search — set at least one (falls back to DuckDuckGo if none set)\nSEARXNG_BASE_URL=http://localhost:8888   # self-hosted SearXNG\nBRAVE_SEARCH_API_KEY=                    # https://api.search.brave.com\n\n# LLM — optional, improves extraction accuracy\nANTHROPIC_API_KEY=\nOPENAI_API_KEY=\n\n# Output directory for CSVs\nLEAD_GEN_OUTPUT_DIR=./leads\n```\n\nCopy `.env.example` for a template.\n\n---\n\n## ICP profiles\n\nThe `profile` parameter tunes candidate ranking for different buyer types:\n\n| Profile | Target |\n|---------|--------|\n| `generic` | Any business |\n| `msp` | Managed service providers (IT/cybersecurity) |\n| `si` | Systems integrators / Microsoft partners |\n| `event_planner` | Event planning / wedding businesses |\n\n## Example prompts\n\n> \"Find 10 MSPs in Austin, Texas and save their contact emails.\"\n\n> \"Search for small systems integrators in the UK, vertical msp_uk, max 5 leads.\"\n\n> \"Discover event planning companies in Chicago — profile: event_planner.\"\n\n## License\n\nMIT\n","readmeFilename":"README.md"}