{
  "markdown": "# @leadloadz/mcp-server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that connects AI assistants to the [Leadloadz](https://www.leadloadz.com) B2B lead generation platform.\n\n## Features\n\n- **Search Leads** — Find verified B2B leads using natural language queries\n- **Verify Email** — Real-time email verification with deliverability scoring\n- **Get Stats** — Check your usage and remaining quotas\n- **Interactive Setup** — Built-in wizard to get your API key\n- **Anonymous Telemetry** — Helps us improve the product (no PII, opt-out via `LEADLOADZ_DISABLE_TELEMETRY=1`)\n\n## Quick Start\n\n### Don't have an API key yet?\n\nRun the setup wizard:\n\n```bash\nnpx @leadloadz/mcp-server --setup\n```\n\nThis will guide you through creating an account and getting your API key.\n\n### Already have an API key?\n\nAdd it to your MCP client configuration (see below) and start using Leadloadz directly.\n\n## Installation\n\n### Via npx (recommended)\n\nNo installation required. AI clients can run the server directly:\n\n```bash\nnpx -y @leadloadz/mcp-server\n```\n\n### Via npm\n\n```bash\nnpm install -g @leadloadz/mcp-server\nleadloadz-mcp\n```\n\n## Configuration\n\nYou need a Leadloadz API key to use this server.\n\n1. Sign up at [leadloadz.com](https://www.leadloadz.com)\n2. Go to **Dashboard → API Tokens**\n3. Generate a new token\n4. Copy the token value\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadloadz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@leadloadz/mcp-server\"],\n      \"env\": {\n        \"LEADLOADZ_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Cline (VS Code)\n\nAdd to your Cline MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadloadz\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@leadloadz/mcp-server\"],\n      \"env\": {\n        \"LEADLOADZ_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Other Clients\n\nAny MCP client that supports stdio transport can use:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@leadloadz/mcp-server\"],\n  \"env\": {\n    \"LEADLOADZ_API_KEY\": \"your-api-key-here\"\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `LEADLOADZ_API_KEY` | **Yes** | — | Your Leadloadz API token |\n| `LEADLOADZ_API_BASE` | No | `https://leadloadz.com/api/mcp` | API base URL (do not use `www` — redirects strip auth headers) |\n| `LEADLOADZ_TIMEOUT_MS` | No | `30000` | Request timeout in milliseconds |\n| `LEADLOADZ_DISABLE_TELEMETRY` | No | `0` | Set to `1` to disable anonymous usage telemetry |\n\n## Tools\n\n### search_leads\n\nSearch indexed B2B contacts by role, company, location, or technology.\n\n**Parameters:**\n- `query` (string, required): Specific natural-language search query\n- `limit` (number, optional): Max results. Default: 10, Cap: 50\n\n**Returns:** Verified leads with deliverability scores\n\n### verify_email\n\nCheck email deliverability in real-time.\n\n**Parameters:**\n- `email` (string, required): Email address to verify\n\n**Returns:** Deliverability score and risk assessment\n\n### get_user_stats\n\nRead current usage counters.\n\n**Returns:** Searches performed, emails verified, and remaining quota\n\n## Security\n\n- Your API key is never logged or exposed in error messages\n- All errors are sanitized to prevent information leakage\n- Communication with Leadloadz APIs uses HTTPS\n\n## Support\n\n- Website: [leadloadz.com](https://www.leadloadz.com)\n- Issues: [GitHub Issues](https://github.com/Ali1041/leadloadz-mcp-server/issues)\n\n## License\n\nMIT\n",
  "bytes": 3542,
  "sha": "0f40f9d748733f537661ca39fa1a785d5e21e59bdc49d406f1e5fcb2a2fa1ca8",
  "repo_slug": "ali1041/leadloadz-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ali1041_leadloadz_423059bf/readme"
}