Quick Diagnostics
Ask your AI assistant: “Check my LeadMagic credit balance.”- Works? Your connection and authentication are fine.
- Doesn’t work? Follow the troubleshooting steps below.
Connection Issues
Server not found or tools not appearing
Server not found or tools not appearing
Symptoms: AI assistant doesn’t recognize LeadMagic tools, “no tools available,” or server appears disconnected.Solutions:
- Verify the URL — ensure your config uses exactly
https://mcp.leadmagic.io/mcp(note the/mcppath). - Restart your client — most MCP clients require a restart after config changes:
- Cursor: Restart the application
- VS Code: Run
Developer: Reload Window - Claude Desktop: Fully quit and reopen
- Windsurf: Restart the application
- Check JSON syntax — a missing comma or bracket in your config file will silently fail. Validate your JSON at jsonlint.com.
- Check the config file location — make sure you’re editing the right file for your client (see setup guide).
Connection timeout or slow responses
Connection timeout or slow responses
Symptoms: Tools take a long time to respond or time out entirely.Solutions:You should see
- Check your internet connection — the MCP server runs at
mcp.leadmagic.ioand requires internet access. - Try the health endpoint — run this in your terminal to verify the server is reachable:
{"ok":true,"service":"lm-mcp",...}.- Rate limits — the LeadMagic API has rate limits. If you’re making many rapid requests, you may be temporarily throttled.
Authentication Errors
401 Unauthorized
401 Unauthorized
403 Forbidden — No credits
403 Forbidden — No credits
Cause: Your account has no remaining credits.Solutions:
- Check your balance at app.leadmagic.io.
- Purchase credits or set up auto top-up.
- See Credits & Pricing for plan options.
Client-Specific Issues
- Cursor
- VS Code
- Claude Desktop
- Claude Code
- Windsurf
Cursor
Config not picked up:- Ensure the file is at
.cursor/mcp.json(project) or~/.cursor/mcp.json(global). - Restart Cursor after any config change.
- Project-level config (
.cursor/mcp.json) takes priority over global (~/.cursor/mcp.json). - If you have both, the project-level config wins.
Tool Errors
Tool returns an error response
Tool returns an error response
MCP tool errors are returned as
isError: true with a message. Common causes:- Missing required parameters — check the tool reference for required fields.
- Invalid parameter format — emails must be valid format, LinkedIn URLs must be full URLs (e.g.,
https://linkedin.com/in/username). - API rate limit — wait a moment and try again.
No data found
No data found
A
not_found result means LeadMagic doesn’t have data for that query. This is free — no credits are charged.Tips to improve results:- Use
domaininstead ofcompany_namefor company lookups. - Use LinkedIn profile URLs when available — they’re the most reliable identifier.
- For
find_email, provide both first and last name plus the company domain.
FAQ
Is my API key stored on the server?
Is my API key stored on the server?
No. Your API key is sent on every request via the
x-leadmagic-key header and is never persisted. The server is fully stateless.Can multiple team members use the same key?
Can multiple team members use the same key?
Yes, but each person using the key consumes credits from the same account. For team usage, consider using separate keys or an organization account with shared credits.
What's the difference between MCP and the REST API?
What's the difference between MCP and the REST API?
They use the same underlying API. The MCP server wraps each API endpoint as an MCP tool so AI assistants can call them directly. Credit costs are identical. If you need programmatic access from your own code, use the REST API directly.
Does the MCP server support SSE transport?
Does the MCP server support SSE transport?
No. The server uses Streamable HTTP transport only (MCP 2025 spec). There is no SSE endpoint. Most supported clients work with Streamable HTTP natively. Claude Desktop and Zed use
mcp-remote to bridge the transport.Can I use this with ChatGPT?
Can I use this with ChatGPT?
Not currently. ChatGPT requires OAuth 2.1 authentication for MCP servers, which this server does not implement. Use the REST API with ChatGPT’s custom GPT actions instead.