Generect Live API MCP Server

Minimal MCP server exposing Generect Live API tools.

Quickstart

1. Install dependencies

npm install

2. Configure environment (via your MCP client settings or a local .env):

GENERECT_API_BASE=https://api.generect.com
GENERECT_API_KEY=Token <api-key>
GENERECT_TIMEOUT_MS=60000

Note: If you provide a raw key without the Token prefix, the server will add it automatically.

3. Dev run

npm run dev

4. Build and start

npm run build && npm start

Tools

• search_leads: Search for leads by ICP filters (supports timeout_ms)
• search_companies: Search for companies by ICP filters (supports timeout_ms)
• generate_email: Generate email by first/last name and domain (supports timeout_ms)
• get_lead_by_url: Get LinkedIn lead by profile URL (supports timeout_ms)
• health: Quick health check against the API (optional url, supports timeout_ms)

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 <api-key>",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

Claude Desktop (MCP) setup

Add to ~/.claude/claude_desktop_config.json (or via UI → MCP Servers):

{
  "mcpServers": {
    "generect-api": {
      "command": "node",
      "args": ["dist/server.js"],
      "env": {
        "GENERECT_API_BASE": "https://api.generect.com",
        "GENERECT_API_KEY": "Token <api-key>",
        "GENERECT_TIMEOUT_MS": "60000",
        "MCP_DEBUG": "0"
      }
    }
  }
}

Docker

Build locally:

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

Run the server in a container:

docker run --rm \
  -e GENERECT_API_BASE=https://api.generect.com \
  -e GENERECT_API_KEY="Token <api-key>" \
  ghcr.io/generect/generect_mcp:local

Remote over SSH (advanced)

Some MCP clients allow spawning the server via SSH, using stdio over the SSH session. Example config:

{
  "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 <api-key>",
        "GENERECT_TIMEOUT_MS": "60000"
      }
    }
  }
}

Local testing helpers

• Run a simple health check against the API:

npm run health -- --key=<api-key>

• Call tools via a local MCP client:

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