generate_email
Generate email by first/last name and domain via Generect Email Generator
LABSCO SUMMARY
It logs which fields were sent, not what was in them.
Lead data is personal data, and a debug log is where it quietly leaks. Request and response payloads are reduced to non-identifying shape markers by default — you can see that a first name was sent without recording the name — and verbatim logging is an explicit opt-in for a short debugging session.
What it is
A minimal MCP server over the Generect Live API for lead generation. Five tools: search leads and companies by ICP filters, pull one lead from a LinkedIn profile URL, generate an email address from a name and a domain, and a health check.
What you get
- search_leads filters by job title, industry, location, company name or company link, with limit, offset, max_items and a compact mode
- search_companies filters by keywords, industries, headcounts and company types, and can fall back to deriving companies from lead results
- get_lead_by_url takes a LinkedIn profile URL and can also return posts, comments and people-also-viewed
- generate_email builds an address from a first name, last name and domain
- health runs a quick lead-by-link request to confirm the API is answering
- Every tool accepts timeout_ms, which matters because these searches are slow by nature
Requirements
The hosted server at https://mcp.generect.com/mcp speaks Streamable HTTP with OAuth 2.1, including dynamic client registration — connect, then paste your Generect API token on the authorization page. Clients that cannot complete OAuth may send the key in an Authorization header instead, including through mcp-remote. For local use: Node 18 or newer with GENERECT_API_BASE, GENERECT_API_KEY, GENERECT_TIMEOUT_MS, JWT_SIGNING_KEY and TOKEN_ENCRYPTION_KEY set. Keys come from beta.generect.com.
Setup effort
One command plus a key — npm i -g generect-ultimate-mcp, then supply credentials
USE CASES
01
Building a list that matches an ICP
Filter leads by title, industry and location, or start from the company side and work down.
02
Enriching a LinkedIn URL you already have
One profile URL in, the full lead record out, optionally with recent posts and comments.
03
Working out a work email from a name and a domain
Generate the likely address rather than guessing at a pattern.
04
Checking the API is answering before a long run
A quick request that fails fast, so a batch does not start against a dead endpoint.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_lead_by_url
Get Lead by LinkedIn URL
health
Health check Generect API via a quick lead-by-link request
search_companies
Search for companies by ICP filters
search_leads
Search for leads by ICP filters
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
GENERECT_API_KEY in your environment
Where it runs
Of the 4 documented setups, 2 run the server on your machine and 2 connect to a hosted endpoint.
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npm
TERMINAL
npm i -g generect-ultimate-mcpHosted endpoint
ENDPOINT URL
https://mcp.generect.com/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"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": "300000",
"MCP_DEBUG": "0"
}
}
}
}Cursor
This block runs the server from a checkout of the repository: git clone https://github.com/generect/generect_mcp.git, then cd generect_mcp and npm install; the paths in it are relative to that folder
Add it to Cursor's MCP settings with your Generect API key after Token (keys come from https://beta.generect.com):
CURSOR · JSON
{
"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": "300000"
}
}
}
}Any MCP client — OAuth
ANY MCP CLIENT — OAUTH · JSON
{
"mcpServers": {
"generect": {
"url": "https://mcp.generect.com/mcp",
"type": "http"
}
}
}Any MCP client — API key
ANY MCP CLIENT — API KEY · JSON
{
"mcpServers": {
"generect": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.generect.com/mcp",
"--header",
"Authorization: Bearer <YOUR_API_KEY>"
]
}
}
}
