Generect Live API

You can run Generect Live API as an MCP server to access lead generation and company search tools from your MCP client. This server exposes a small, focused set of endpoints that you can connect to via remote or local execution modes, making it easy to integrate Generect capabilities into your workflow.

How to use

To use the Generect MCP server, configure your MCP client to connect to either the hosted remote server or a local instance. Choose the remote option for a hosted solution or run the local server on your own infrastructure and point your MCP client to it. You will interact with the available tools by sending requests that perform lead searches, company lookups, email generation, and LinkedIn lead retrieval.

How to install

Prerequisites: Node.js version 18 or newer installed on your machine.

Option A: Remote MCP server (recommended) Configure your MCP client to use the hosted server via the provided MCP URL and include your API key in the authorization header.

Option B: Local installation (alternative) Follow these steps to run the server locally.

{
  "mcpServers": {
    "generect": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.generect.com/mcp",
        "--header",
        "Authorization: Bearer Token YOUR_API_KEY"
      ]
    }
  }
}

How to install

Follow these concrete steps to set up a local instance.

# Prerequisites
node -v  # should be v18 or newer
npm -v   # ensure npm is available

# 1) Set environment variables (adjust values to your setup)
GENERECT_API_BASE=https://api.generect.com
GENERECT_API_KEY=Token <your_api_key_here>
GENERECT_TIMEOUT_MS=60000

How to install

2. Install dependencies (local development setup)

npm install

How to install

3. Run in development mode (optional)

npm run dev

How to install

4. Build and start the stdio server (production-like run) The final start command uses the start script; building should be completed prior to starting.

npm run build
npm start

Tools

The Generect MCP server provides several tools to help you search leads, search companies, generate emails, fetch LinkedIn leads by profile URL, and perform a health check against the API.

Cursor integration (settings.json excerpt)

{
  "mcpServers": {
    "generect-liveapi": {
      "command": "node",
      "args": ["./node_modules/tsx/dist/cli.mjs", "src/server.ts"],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

Claude Desktop (MCP) setup

You can add the Generect MCP server to Claude Desktop by configuring an MCP server entry that runs via npx. This avoids installing global packages.

{
  "mcpServers": {
    "generect-api": {
      "command": "npx",
      "args": ["-y", "generect-ultimate-mcp@latest"],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000",
        "MCP_DEBUG": "0"
      }
    }
  }
}

Claude Desktop (MCP) setup

macOS users may need to set the absolute npx path if Claude shows spawn errors. You can override the command and PATH as needed.

{
  "command": "/usr/local/bin/npx",
  "env": { "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin" }
}

Claude Desktop alternative without npx

If you prefer not to use npx, you can install the MCP locally and run it directly.

npm i -g generect-ultimate-mcp

{ "command": "/usr/local/bin/generect-mcp", "args": [] }

Docker

You can run the Generect MCP server in a Docker container. Build the image locally and run it with the required environment variables.

# Build locally
docker build -t ghcr.io/generect/generect_mcp:local .

# Run the container
docker run --rm \
  -e GENERECT_API_BASE=https://api.generect.com \
  -e GENERECT_API_KEY="Token YOUR_API_KEY" \
  ghcr.io/generect/generect_mcp:local

Remote over SSH (advanced)

Some MCP clients support running the server over an SSH session. You can configure an SSH command that starts the server remotely.

{
  "mcpServers": {
    "generect-remote": {
      "command": "ssh",
      "args": [
        "user@remote-host",
        "-T",
        "node",
        "/opt/generect_mcp/dist/server.js"
      ],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token YOUR_API_KEY",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

Local testing helpers

Quickly test connectivity and tool calls against the API using local helper commands. These help you verify that the MCP server is correctly wired to Generect.

npm run health -- <api-key>

npm run mcp:client -- <api-key>

Available tools

search_leads

Search leads using ICP filters with optional timeout setting to limit request duration.

search_companies

Search companies using ICP filters with optional timeout setting to limit request duration.

generate_email

Generate a professional email address given a first name, last name, and domain, with support for a request timeout.

get_lead_by_url

Retrieve a LinkedIn lead profile by providing the profile URL, with optional timeout.

health

Perform a quick health check against the Generect API, with optional URL and timeout parameters.