⚡ The Ultimate Model Context Protocol Server for B2B Data Enrichment
Seamlessly integrate LeadMagic's complete API suite with Claude, Cursor, Windsurf, and all MCP-compatible AI tools
🎯 19 Powerful Tools • 🔥 Zero Configuration • ⚡ One-Line Setup • 🛡️ Enterprise Security
- 🚀 Super Easy Installation
- 🛠️ Available Tools
- 💡 Usage Examples
- 🌐 Supported MCP Clients
- 🔧 Development Setup
- 🏗️ Architecture
- 📊 API Reference
- 🔒 Security & Best Practices
- 🎯 Installation Matrix
- 🤝 Support & Resources
- 📄 License
- 🙋♀️ Contributing
- 🔄 Updates & Changelog
🎯 Access all 19 LeadMagic API endpoints through the Model Context Protocol for seamless integration with Claude, Cursor, Windsurf, Continue.dev, and other MCP-compatible AI tools.
The easiest way to get started - works on macOS, Windows, and Linux. Our new interactive installer, built with React and Ink, makes setup a breeze.
# 🔥 Using npx (no installation required)
npx leadmagic-mcp-server install✨ The installer will:
- ✅ Validate your API key in real-time and show your remaining credits.
- ✅ Automatically detect and configure your preferred AI tool (Claude, Cursor, VS Code, etc.).
- ✅ Create all necessary config files and a local
.envfor development. - ✅ Provide usage examples and helpful links.
If you prefer manual setup or are using a client like Aider, you can add the server configuration directly to your client's settings file. The interactive installer provides copy-pasteable snippets for this.
Run the installer and choose the "Other (Manual Setup)" option:
npx leadmagic-mcp-server install- 🌐 Visit LeadMagic Dashboard
- 📝 Sign up for free (if needed)
- 🔐 Generate your API key
- 📋 Paste it into the interactive installer when prompted.
You can use the server without installing, which is great for quick tests or containerized environments:
# 🚀 Run directly with your API key
LEADMAGIC_API_KEY=your-key npx leadmagic-mcp-server
# 📋 Run the interactive installer
npx leadmagic-mcp-server install
# ❓ Check available commands
npx leadmagic-mcp-server --help- 💳
get_credits- Check API credit balance - ✅
validate_email- Validate email deliverability and get company info - 📧
find_email- Find verified email addresses by name and company
- 👤
search_profile- Get full B2B profile details (300 req/min) - 🏭
search_company- Search companies by domain, name, or profile URL - 📱
find_mobile- Find mobile phone numbers from profiles/emails - 🔗
email_to_profile- Find B2B profile URLs from work emails - 💰
get_company_funding- Get funding, financials, and competitor data
- 📨
find_personal_email- Find personal emails from B2B profiles - 🔄
social_to_work_email- Find work emails from social profiles
- 🔍
find_jobs- Search job postings with advanced filters - 👔
find_role- Find specific roles within companies - 👥
find_employees- Find employees of specific companies - 🌍
get_job_countries- Get available job search countries - 📋
get_job_types- Get available job types for filtering
- 🔍
search_google_ads- Search Google Ads by company - 📘
search_meta_ads- Search Meta (Facebook/Instagram) Ads - 📈
search_b2b_ads- Search B2B advertising campaigns - 📄
get_b2b_ad_details- Get detailed B2B ad information
Once installed, you can use natural language commands in your AI tool:
"Find the email for John Doe at Microsoft"
"Validate the email john@acme.com"
"Find personal email for B2B profile https://linkedin.com/in/johndoe"
"Search for Tesla company information"
"Get funding information for Stripe"
"Find employees at OpenAI who work in engineering"
"Find software engineer jobs at tech companies"
"Search for product manager roles in San Francisco"
"Find mobile number for this B2B profile"
"Search for Google Ads from competitor.com"
"Find Meta ads for company XYZ"
"Get B2B advertising campaigns for stripe.com"
- 📦 Node.js 18.0.0 or higher
- 🔑 LeadMagic API key from leadmagic.io
# 📥 Clone the repository
git clone https://github.com/LeadMagic/leadmagic-mcp.git
cd leadmagic-mcp
# 📦 Install dependencies
npm install
# 🔐 Create environment file
echo "LEADMAGIC_API_KEY=your-api-key-here" > .env
# 🚀 Start development server
npm run dev
# 🏗️ Build for production
npm run build
# ✅ Run validation
npm run validate# 🚀 Start the MCP inspector
npm run inspector
# 🌐 Open the provided URL in your browser to test all tools| Client | Installation | Status | Notes |
|---|---|---|---|
| 🤖 Claude Desktop | Interactive installer or manual config | ✅ Fully Supported | Official Anthropic client |
| 🎯 Cursor (Cline) | Interactive installer or VS Code settings | ✅ Fully Supported | Requires Cline extension |
| 🏄 Windsurf | Interactive installer or manual config | ✅ Fully Supported | Codeium's AI IDE |
| 🔄 Continue.dev | Interactive installer or config file | ✅ Fully Supported | Open source coding assistant |
| 💻 VS Code (Cline) | VS Code settings.json | ✅ Fully Supported | Requires Cline extension |
| 💻 VS Code (Continue) | Continue extension config | ✅ Fully Supported | Requires Continue extension |
| ⚡ Zed Editor | Interactive installer or settings | ✅ Fully Supported | Modern code editor |
| 🤖 Aider | Manual Configuration | ✅ Supported | AI pair programming in your terminal |
| ✨ Augment Code | Manual Configuration | ✅ Supported | AI coding assistant |
| 🔗 Any MCP Client | Manual configuration | ✅ Supported | Standard MCP protocol |
- ⚡ Runtime: Node.js 18+
- 📘 Language: TypeScript with strict type checking
- 🔌 MCP SDK: @modelcontextprotocol/sdk v1.0.0+
- 🌐 HTTP Client: Axios with comprehensive error handling
- ✅ Validation: Zod schemas for all API inputs/outputs
- 🔧 Development: ESLint, Prettier, Jest for testing
├── src/
│ ├── index.ts # 🚀 Main entry point and CLI command handling
│ ├── server.ts # 🔌 MCP server implementation with all 19 tools
│ ├── client.ts # 🌐 LeadMagic API client wrapper
│ ├── types.ts # 📝 TypeScript types and Zod schemas
│ └── install.tsx # 🎨 The new interactive installer (React/Ink)
├── dist/ # 📦 Compiled JavaScript output
├── .env.example # 🔐 Environment configuration example
└── README.md # 📚 This file
All fields use snake_case (matching LeadMagic API):
{
"first_name": "John",
"company_name": "Acme Corp",
"email_status": "valid"
}Include your API key in requests:
X-API-Key: your-leadmagic-api-key- 👤 Profile Search: 300 requests/minute
- 📊 Other endpoints: Standard rate limits apply
Consistent error format across all endpoints:
{
"error": "Bad Request",
"message": "API key is missing or invalid."
}| Endpoint | Credits | Notes |
|---|---|---|
💳 /credits |
0 | Free to check |
✅ /email-validate |
0.05 | Very cost-effective |
📧 /email-finder |
1 | Standard rate |
📱 /mobile-finder |
5 | Only if found |
👤 /profile-search |
1 | Rate limited (300/min) |
🔗 /b2b-profile |
10 | Higher cost for reverse lookup |
💰 /company-funding |
4 | Premium intelligence |
💼 /jobs-finder |
1 per job | Based on results |
🔍 /google/searchads |
1 per ad | Based on ads found |
| 📊 All others | 1-2 | Standard rates |
✅ No API keys in code - Always use environment variables
✅ Type-safe requests - Full TypeScript coverage with Zod validation
✅ Error handling - Comprehensive error catching and user-friendly messages
✅ Rate limiting - Respects LeadMagic API rate limits
✅ Secure defaults - Production-ready configuration out of the box
✅ Interactive installer - No manual config file editing required
Choose your installation method based on your setup:
| Scenario | Command | Best For |
|---|---|---|
| 🆕 First time user | npx leadmagic-mcp-server install |
Easiest setup |
| 🤖 Claude Desktop | Interactive installer → Option 1 | Most popular |
| 🎯 Cursor/VS Code | Interactive installer → Option 2/5 | Developers |
| 🔄 Multiple clients | Interactive installer → Option 7 | Power users |
| ⚡ Quick test | LEADMAGIC_API_KEY=key npx leadmagic-mcp-server |
Testing |
| 💻 Local development | Clone repo + .env file |
Contributors |
- 📚 API Documentation: docs.leadmagic.io
- 🌐 Official Website: leadmagic.io
- 📊 Dashboard: app.leadmagic.io
- 🆘 Support: support@leadmagic.io
- 🐛 Issues: GitHub Issues
- 💬 Community: Join our Discord
- 🐙 Source Code: GitHub Repository
MIT License - see the LICENSE file for details.
We welcome contributions! Here's how to get started:
- 🍴 Fork the repository
- 🌿 Create a feature branch:
git checkout -b feature/new-feature - ✨ Make your changes and add tests
- ✅ Run validation:
npm run validate - 💾 Commit your changes:
git commit -am 'Add new feature' - 📤 Push to the branch:
git push origin feature/new-feature - 🔄 Submit a pull request
Found a bug? Please open an issue with:
- 📝 Clear description of the issue
- 🔄 Steps to reproduce
- 💻 Your environment details
- 📋 Expected vs actual behavior
Have an idea? Request a feature with:
- 📖 Clear description of the feature
- 🎯 Use case and benefits
- 💭 Any implementation ideas
- 🎨 Redesigned README with professional and impactful header
- 📦 Enhanced package.json with better description and keywords
- 🎯 Improved branding and visual presentation
- 🔧 Documentation polish and terminology consistency
- 🏷️ Added enhanced badges with security verification
- 📚 Overall professional presentation improvements
- ✨ Interactive installer for all major AI tools
- ✅ Support for Claude Desktop, Cursor, Windsurf, Continue.dev, VS Code, Zed
- 🔧 All 19 LeadMagic API endpoints implemented
- 🎯 Zero-config npx usage
- 🔒 Enhanced security and error handling
- 📚 Comprehensive documentation
🎉 Built with the official LeadMagic OpenAPI specification for 100% API accuracy
Made with ❤️ by the LeadMagic team