Leadloadz MCP Server Setup: Claude, Cursor & Custom Agents

Leadloadz MCP Server Setup Guide

This guide covers everything you need to connect the Leadloadz MCP server to Claude Desktop, Cursor, or a custom agent — plus troubleshooting and advanced configuration.

Quick Start (2 minutes)

Sign up → create a token → add the config → start searching.

Claude Desktop Setup

1. Open Claude → Settings → Developer → Edit Config.

2. Add:

{
  "mcpServers": {
    "leadloadz": {
      "command": "npx",
      "args": ["-y", "@leadloadz/mcp-server"],
      "env": { "LEADLOADZ_API_TOKEN": "your_token_here" }
    }
  }
}

3. Save and restart Claude.

4. Verify by asking: "How many lead searches do I have left?"

Cursor IDE Setup

1. Open Settings → MCP → Add Server.

2. Use the same command/args/env as above.

3. Test in Chat or Composer with a sample search.

Custom Agent Setup

For custom agents, call the MCP endpoint directly:

• Endpoint: `https://leadloadz.com/api/mcp`
• Auth: `Authorization: Bearer YOUR_TOKEN`
• Format: JSON-RPC 2.0

Example tool call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_leads",
    "arguments": { "query": "VP Sales at SaaS companies", "limit": 20 }
  }
}