leadmagic

LeadMagic MCP Server exposes 19 tools to perform B2B data enrichment and profiling via the MCP interface. After starting the server, clients can issue commands to access credits, validate emails, find emails, search company and profile details, obtain funding data, and perform advanced email finding, job and employee intelligence, and advertising intelligence tasks. The server is designed to integrate with Claude, Cursor, Windsurf, and other MCP-compatible AI tools, enabling natural-language prompts that map to the underlying LeadMagic API endpoints. Typical workflows include checking remaining credits before a request, validating a lead’s email, and then enriching that lead’s profile with company data or funding information. The tools are grouped into core operations, profile & company intelligence, email finding, job/employee intelligence, and advertising intelligence, providing a broad set of capabilities for business intelligence and data enrichment within MCP-enabled assistants.

Prerequisites:

• Node.js 18.0.0 or higher
• npm (comes with Node.js)
• A LeadMagic API key

Installation steps:

1. Clone the repository or install the package from npm (if you’re using the package directly):

   • git clone https://github.com/LeadMagic/leadmagic-mcp.git
   • cd leadmagic-mcp

2. Install dependencies:

   • npm install

3. Provision your environment with your API key:

   • echo "LEADMAGIC_API_KEY=your-api-key-here" > .env

4. Start the server in development mode (as per the README):

   • npm run dev

5. For production deployment, build the project and run the built server:

   • npm run build
   • node dist/index.js

Optional quick start (npx, if available):

• LEADMAGIC_API_KEY=your-key npx leadmagic-mcp-server
• npx leadmagic-mcp-server install # interactive installer (if provided by the package)

Prerequisites verification:

• Ensure your API key is valid and has access to the LeadMagic endpoints you plan to use.
• Ensure network access to LeadMagic API endpoints from the deployment environment.

Tips and considerations:

• Save your API key securely; avoid hard-coding it in source files.
• The server exposes 19 tools; organize prompts to target specific tool names (e.g., get_credits, find_email, search_profile).
• If integrating with MCP clients, confirm that the client supports environment variable passthrough and that the server’s port is reachable by the client.
• Monitor usage limits per your LeadMagic plan to avoid unexpected throttling.
• For production deployments, consider using a process manager (e.g., PM2) and configuring logging and restart policies.
• If you encounter authentication or quota errors, verify account status and key permissions in the LeadMagic dashboard.