LeadMagic

🎯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.

⚡ Option 1: Interactive Installer (Recommended)

The easiest way to get started - works onmacOS,Windows, andLinux. Our new interactive installer, built with React and Ink, makes setup a breeze.

# 🔥 Using npx (no installation required) npx leadmagic-mcp-server install

- ✅Validate your API keyin 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 likeAider, you can add the server configuration directly to your client's settings file. The interactive installer provides copy-pasteable snippets for this.

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

🏢 Profile & Company Intelligence (5 tools)

- 👤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

💼 Job & Employee Intelligence (5 tools)

- 🔍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"

# 📥 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

- ⚡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" }

- 👤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." }

✅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:

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

- 📝 Clear description of the issue
- 🔄 Steps to reproduce
- 💻 Your environment details
- 📋 Expected vs actual behavior

- 📖 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

🌟 Star us on GitHub • 🐛 Report Issues • 💡 Request Features

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

Research tools, including a Sqlite-backed document stash

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.