Skip to content
This repository was archived by the owner on Aug 25, 2026. It is now read-only.

CHANGELOG.md

Latest commit

 

History

History
211 lines (175 loc) · 9.09 KB

CHANGELOG.md

File metadata and controls

211 lines (175 loc) · 9.09 KB
Raw

📋 Changelog

All notable changes to LeadMagic MCP Server will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.2] - 2025-06-27

✨ Repository Polish & GitHub Setup

  • 📝 GitHub Setup Guide: Created detailed repository configuration instructions
  • 👥 Code Owners: Added CODEOWNERS file for team collaboration
  • 📦 NPM Package: Enhanced .npmignore for cleaner package distribution
  • 🏷️ Enhanced Keywords: Added more discoverable keywords for better SEO
  • 🔧 Package Polish: Improved files array and metadata for npm distribution
  • 📊 Repository Analytics: Optimized for developer discoverability
  • 🔧 Workflow Fixes: Fixed deprecated GitHub Actions and improved release process
  • 🔄 Updated Dependencies: Updated MCP SDK to v1.13.0 for latest features
  • 🛠️ CI Improvements: Updated to Node.js 20 and improved cross-platform testing

📚 Documentation

  • 🎯 Complete Setup Guide: Step-by-step GitHub repository configuration
  • 🔖 Topics & Tags: Comprehensive list of repository topics
  • 🌐 Social Preview: Instructions for professional repository appearance
  • ⚙️ Repository Features: Guide for enabling all GitHub features

🧹 Cleaned

  • 🚫 Removed Funding: Removed GitHub sponsorship and funding configurations
  • 🔧 Fixed Workflows: Updated deprecated actions and improved reliability
  • 🛡️ ESLint Fixes: Resolved configuration issues and improved error handling
  • ⚡ CI Pipeline: More robust testing with better error tolerance

📝 Notes

  • Some deprecation warnings in npm install are from transitive dependencies and don't affect functionality
  • CI now uses Node.js 20 for optimal compatibility with all dependencies

[1.0.1] - 2025-06-27

✨ Enhanced

  • 🎨 Redesigned README: More professional and impactful header with enhanced badges and styling
  • 📦 Improved package.json: Enhanced description, better keywords, and professional author info
  • 🎯 Better branding: Updated title and enhanced visual presentation
  • 🔧 Documentation polish: Cleaned up terminology and improved professional presentation
  • 🏷️ Enhanced badges: Added download count, security verification, and production-ready badges
  • 🎨 Visual improvements: Better color scheme and professional badge styling

🧹 Cleaned

  • 📝 Documentation consistency: Improved B2B profile terminology throughout
  • 🔗 Contributing URLs: Fixed all placeholder URLs to proper LeadMagic organization
  • 📚 Professional presentation: Enhanced overall documentation quality and readability

[1.0.0] - 2025-06-27

🎉 Major Release - Production Ready

  • ✨ Complete LeadMagic API Integration: All 19 endpoints implemented with full TypeScript support
  • 🔌 Universal MCP Support: Compatible with Claude Desktop, Cursor, Windsurf, Continue.dev, VS Code, Zed
  • 🛠️ Interactive Installer: Zero-config setup for all major AI tools and MCP clients
  • 🎯 Zero Configuration: One-line npx setup with automatic client detection
  • 🔒 Enterprise Security: Production-ready security, validation, and error handling
  • 📚 Comprehensive Documentation: Complete guides, examples, and troubleshooting

✨ Added

Complete API Coverage

  • All 19 LeadMagic API endpoints fully implemented and tested
  • Email validation and finding capabilities
  • Profile and company search functionality
  • Mobile number discovery
  • Job and employee intelligence
  • Company funding and financial data
  • Advertisement intelligence (Google, Meta, B2B)
  • Complete type safety with Zod schemas

Universal MCP Client Support

  • Interactive installer for easy setup across all platforms
  • Claude Desktop - Official Anthropic client support
  • Cursor - Cline extension integration
  • Windsurf - Codeium's AI IDE support
  • Continue.dev - Open source coding assistant
  • VS Code - Cline and Continue extension support
  • Zed Editor - Modern code editor integration
  • Any MCP-compatible client - Standard protocol support

Developer Experience

  • Zero-config npx usage - Run without installation
  • TypeScript-first with strict type checking
  • Comprehensive error handling with user-friendly messages
  • Production-ready configuration out of the box
  • Automatic config detection for multiple platforms
  • Interactive CLI with colored output and clear instructions

API Features

  • Rate limiting compliance with LeadMagic API limits
  • Comprehensive validation using Zod schemas
  • Error recovery and retry logic
  • Secure credential handling via environment variables
  • Request/response logging for debugging
  • Custom timeout configuration

Documentation & Testing

  • Complete README with installation matrix
  • API reference with credit consumption details
  • Usage examples for all 19 endpoints
  • Live API validation with real endpoint testing
  • MCP inspector support for development
  • Security best practices documentation

Distribution & Installation

  • npm package ready for global distribution
  • GitHub repository with complete source code
  • Interactive installer binary (leadmagic-mcp-install)
  • Environment templates (.env.example)
  • Cross-platform support (macOS, Windows, Linux)

🛠️ Technical Details

Architecture

  • Node.js 18+ runtime support
  • ES modules with modern JavaScript
  • MCP SDK v1.0.0+ for protocol compliance
  • Axios HTTP client with comprehensive error handling
  • Zod validation for all API inputs and outputs
  • ESLint & Prettier for code quality

API Endpoints Implemented

  1. Credits Management

    • get_credits - Check API credit balance

  2. Email Operations

    • validate_email - Email deliverability validation
    • find_email - Find verified email addresses
    • find_personal_email - Personal email discovery
    • social_to_work_email - Work email from social profiles

  3. Profile & Company Intelligence

    • search_profile - B2B profile enrichment (300 req/min)
    • search_company - Company data enrichment
    • email_to_profile - B2B profile URLs from emails
    • get_company_funding - Funding, financials, competitors

  4. Contact Discovery

    • find_mobile - Mobile phone number finder

  5. Job & Employee Intelligence

    • find_jobs - Job posting search with filters
    • find_role - Specific role/position finder
    • find_employees - Company employee discovery
    • get_job_countries - Available job search countries
    • get_job_types - Available job types for filtering

  6. Advertisement Intelligence

    • search_google_ads - Google Ads search
    • search_meta_ads - Meta (Facebook/Instagram) Ads
    • search_b2b_ads - B2B advertising campaigns
    • get_b2b_ad_details - Detailed B2B ad information

🔒 Security Features

  • No API keys in code - Environment variable only
  • Secure configuration - Automatic .gitignore setup
  • Input validation - All requests validated with Zod
  • Error sanitization - No sensitive data in error messages
  • Rate limiting respect - Complies with API limits

📊 Credit Consumption Reference

Endpoint Credits Notes
/credits 0 Free balance check
/email-validate 0.05 Very cost-effective
/email-finder 1 Standard rate
/mobile-finder 5 Only charged 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

🌐 Compatibility Matrix

Platform Installation Method Status
macOS Interactive installer ✅ Fully tested
Windows Interactive installer ✅ Fully tested
Linux Interactive installer ✅ Fully tested
Claude Desktop Auto-config ✅ Production ready
Cursor + Cline Auto-config ✅ Production ready
Windsurf Auto-config ✅ Production ready
Continue.dev Auto-config ✅ Production ready
VS Code Auto-config ✅ Production ready
Zed Auto-config ✅ Production ready

📝 Notes

Future Releases

Planned Features

  • Additional authentication methods
  • Webhook support for real-time updates
  • Batch processing capabilities
  • Advanced caching strategies
  • Performance monitoring and analytics
  • API rate limiting dashboard

For support, issues, or feature requests, visit GitHub Issues