# Generect

B2B contact and company lookup for AI agents. Sizing audiences is free, and costs apply only when valid emails, phone numbers, or profiles turn up.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: generect
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/generect/generect_mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/generect

## What it does

This server connects AI assistants directly to the Generect B2B directory. Calculating total reach and running preliminary searches with core attributes (name, role, employer, location) incur no charges under the daily account limit. Credits are deducted solely when valid email addresses, phone records, or detailed resumes are found.

You can connect remotely to `https://mcp.generect.com/mcp` over HTTP with OAuth 2.1 login, avoiding manual header setups. Stdio execution via `generect-ultimate-mcp` is also supported. Running locally demands Node 20 or newer. When used inside clients that support MCP Apps, data renders as interactive cards and tables where you pick prospects before triggering a lookup.

Every tool signals its billing nature ahead of time and returns actual deductions in a `cost` payload. Actions crossing threshold amounts demand manual confirmation. To build pipelines without touching your balance, provide a `test_…` API key to receive fictional records marked with zero cost.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.generect.com/mcp`
- Environment variables: `GENERECT_API_KEY`, `GENERECT_API_BASE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http generect-mcp https://mcp.generect.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env GENERECT_API_KEY=<GENERECT_API_KEY> --env GENERECT_API_BASE=<GENERECT_API_BASE> --transport stdio generect -- npx -y generect-ultimate-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add generect --url https://mcp.generect.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add generect --env GENERECT_API_KEY=<GENERECT_API_KEY> --env GENERECT_API_BASE=<GENERECT_API_BASE> -- npx -y generect-ultimate-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "generect": {
            "url": "https://mcp.generect.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "generect": {
            "command": "npx",
            "args": [
                "-y",
                "generect-ultimate-mcp"
            ],
            "env": {
                "GENERECT_API_KEY": "<GENERECT_API_KEY>",
                "GENERECT_API_BASE": "<GENERECT_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "generect": {
            "type": "http",
            "url": "https://mcp.generect.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "generect": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "generect-ultimate-mcp"
            ],
            "env": {
                "GENERECT_API_KEY": "<GENERECT_API_KEY>",
                "GENERECT_API_BASE": "<GENERECT_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http generect https://mcp.generect.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e GENERECT_API_KEY=<GENERECT_API_KEY> -e GENERECT_API_BASE=<GENERECT_API_BASE> generect npx -y generect-ultimate-mcp
```
Replace <…> with your own values

## When to use it
- Size candidate pools matching specific industry and role criteria
- Identify decision makers across targeted enterprise accounts
- Retrieve verified work email addresses for cold outreach
- Enrich prospect records with employment history

## Example prompts
- Count how many VP of Engineering profiles match Series B startups in Germany
- Search for marketing leads at European SaaS firms and retrieve their verified emails
- Check my Generect account balance and active pricing per call

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md