How do I install Generect?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Generect need an API key?

The publisher lists these environment variables: GENERECT_API_KEY, GENERECT_API_BASE.

When was Generect last checked?

Last checked 2026-10-23. B2B lead and company data for AI agents: free search, pay only for emails, phones, profiles.

Generect MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.generect.com/mcp

Credentials from the publisher

GENERECT_API_KEY — Your Generect API key from app.generect.com/settings/api (a test_ key returns fictional data for free).
GENERECT_API_BASE — API base URL.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.generect-generect-mcp https://mcp.generect.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.generect-generect-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.generect.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.13.2

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Give Claude, ChatGPT, Cursor or your own agent access to the Generect B2B database: people and companies by ICP, emails, phones and full profiles.

Free to explore. Counting an audience is free, and so is a database search with thin rows (who, role, where, which company), up to a daily row quota per account.
Pay for what you keep. Emails are billed only when a valid one is found, phones only when found, full profiles per record found.
No surprise bills. Every tool says up front whether it costs money, every response carries a cost block with the amount actually charged, and calls above a spend ceiling need an explicit confirmation. Tools that can charge are not marked read-only, so Claude and other hosts ask before running them (choose "Always allow" for the ones you trust); counting, balance and health run without asking.
Safe to try. A test key returns realistic fictional data at real speed and charges nothing.
Interactive in the chat. In Claude, ChatGPT and other hosts that support MCP Apps, results come back as cards you can act on: an audience card with prices, a lead table where you pick people and find their emails, company and profile cards, your balance.

Connect

Get an API key at app.generect.com/settings/api. Clients that support OAuth sign you in without one.

Remote server (recommended)

https://mcp.generect.com/mcp speaks streamable HTTP with OAuth 2.1, so most clients only need the URL. It serves MCP protocol revision 2026-07-28 (stateless, discovered via server/discover) and the 2025 revisions (2025-11-25, 2025-06-18) side by side, so any current client connects without settings.

Claude Code

claude mcp add --transport http generect https://mcp.generect.com/mcp

Claude.ai and Claude Desktop: Settings, Connectors, Add custom connector, then paste https://mcp.generect.com/mcp.

Cursor (.cursor/mcp.json) and other JSON-configured clients:

{
  "mcpServers": {
    "generect": {
      "url": "https://mcp.generect.com/mcp"
    }
  }
}

The first connection opens the Generect consent page in the browser. Approve it with the account you are already signed into, and the client receives its own token.

No OAuth in your client? Pass the key as a header, for example with mcp-remote:

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

Local server (stdio)

{
  "mcpServers": {
    "generect": {
      "command": "npx",
      "args": ["-y", "generect-ultimate-mcp@latest"],
      "env": {
        "GENERECT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Requires Node 20 or newer. Optional: GENERECT_API_BASE (default https://api.generect.com) and GENERECT_TIMEOUT_MS. If Claude Desktop on macOS reports spawn npx ENOENT, set command to the absolute path of npx.

Test mode

Use a test_… key from app.generect.com/settings/api in any of the configs above. Every tool then answers with fictional data, shows what the real call would have cost and charges nothing. Results carry test_mode: true so an agent cannot mistake them for real people. See Test mode.

Interactive results (MCP Apps)

Hosts that support the MCP Apps extension (Claude on web, desktop and mobile, ChatGPT, VS Code, Goose and others) render these tools as interactive views inside the conversation. Other clients get the same text and structured results as before.

Tool	What you see
`count_leads`, `count_companies`	The audience size, your filters, what the next step costs at your prices, and a button to see the first 25
`search_leads`, `preview_leads`	The top people inline; open all of them as a table, filter, select, and find work emails right there. You confirm the maximum before anything is spent, a miss is free, and found emails go back to Claude so it can use them
`search_companies`	Company cards and a table, with a one-click ask for decision makers at them
`enrich_lead`, `get_lead_by_url`, `enrich_company`	A profile card with the experience timeline and a find-email button
`get_balance`	Balance, this month's spend and your per-operation prices
`generate_email`	Which emails were found and what it cost

The views follow the host's theme (light and dark), fonts and layout, and work on phones. Results from a test key are labelled as fictional.

Tools

Free

Tool	What it does
`count_leads`	How many people match an ICP, and what the next step costs at your rates. Start here.
`count_companies`	The same for companies.
`search_leads`	People matching an ICP. Free with the default thin rows (database mode, daily quota).
`search_companies`	Companies matching an ICP. Free with the default thin rows (database mode, daily quota).
`get_balance`	Balance, your real per-operation prices, and optionally spend by operation or by token.
`get_bulk_job`	Poll a bulk job (the work was billed at submit time).
`manage_webhooks`	List, create, update, delete or test webhook endpoints.
`health`	Liveness and credential check against a free endpoint. Safe for monitors.

Billable

Tool	Billed
`search_leads`, `search_companies` with `detail: "full"`, in realtime mode and once the free quota is used up	per returned row
`preview_leads`	per returned row (`count_only: true` is free)
`resolve_profile`	per resolved profile, the cheapest paid call; an unresolvable link is free
`enrich_lead`, `get_lead_by_url`	per record found
`enrich_company`	per record found
`generate_email`	per valid email found
`validate_email`	per email submitted, whatever the verdict
`find_phone`	per phone found, the most expensive operation
`start_bulk_job`	per record, reserved when the job is submitted

Prices depend on your account tier: get_balance returns yours, and every response reports what was actually charged.

A budget-safe flow

count_leads (free)  →  search_leads, thin rows (free)  →  generate_email on the ids you keep (per valid email)
                                                        →  enrich_lead / find_phone only where needed

Thin and full rows

search_leads and search_companies take detail:

left out (default): thin rows while the free tier is available. Once it is not (quota spent, a custom-contract account), the search continues with full rows billed per row and says so in thin_unavailable.
"thin": free rows only. Never billed and never escalated to realtime; a spent quota returns a 429.
"full": the whole record, billed per row.

Thin lead rows carry id, name, job title, seniority, location and company (name, id, industry, country). Thin company rows carry id, name, industry, headcount range, HQ city and country, company type and founding year. Neither carries a LinkedIn URL, domain, contacts or history: generate_email takes the lead id directly, and enrich_lead / enrich_company return the full record.

Database and realtime

Search and enrich run against the Generect database (sub-second, free counts) or a live LinkedIn lookup (5 to 60 seconds, billed counts, every filter). Tools take mode:

auto (default) tries the database first and escalates only if the API says a filter you passed is not supported there. The escalation is reported and is refused above the spend ceiling.
database never escalates: an unsupported filter is an error, not a bigger bill.
realtime goes live directly. Counting live costs money, so count_* run it only when asked for explicitly.

Filter vocabularies

company_industries and seniorities accept unknown values silently and return zero results, which reads like "this audience does not exist". The server therefore checks values before sending anything: unknown industries, headcount buckets and company types are refused locally with the closest valid names, and mis-cased values are corrected. allow_unlisted_values: true overrides the check.

The full vocabularies are exposed as resources:

generect://vocabulary/industries
generect://vocabulary/seniorities
generect://vocabulary/functions         (realtime only)
generect://vocabulary/company-types
generect://vocabulary/headcounts
generect://vocabulary/follower-ranges   (realtime only)
generect://account/pricing              your per-operation prices
generect://account/balance              balance and month-to-date usage

Prompts

Workflow prompts appear as slash commands in clients that support them: size_an_audience, build_prospect_list, enrich_my_list and spend_report. Each one starts from the free step.

Spend ceiling

A row cap bounds results, not money. Any call whose worst case exceeds MCP_MAX_SPEND_PER_CALL (default $5) is refused with the exact figure and must be repeated with confirm_spend_usd set to at least that amount. start_bulk_job is checked before it submits, because a bulk job reserves its whole cost up front.

Agent skill

Tools let an agent call Generect; the skill teaches it the procedure above.

npx skills add generect/generect_mcp --skill generect-lead-workflows

See skills/README.md.

Documentation
Operating and self-hosting the server: logging, OAuth endpoints, security settings, deployment, Docker
Release process
Issues

License

MIT

Generect

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Generect?

Does Generect need an API key?

What transport does Generect use?

When was Generect last checked?

Documentation

Connect

Remote server (recommended)

Local server (stdio)

Test mode

Interactive results (MCP Apps)

Tools

A budget-safe flow

Thin and full rows

Database and realtime

Filter vocabularies

Prompts

Spend ceiling

Agent skill

More

License