> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local MCP (npx)

> Quick guide to use Generect MCP with local installation

Our MCP server provides integration between the **Generect Live API** and any Client that supports MCP (e.g., [Cursor](https://cursor.com/home), [Claude Desktop](https://claude.ai/download), [OpenAI's Responses API](https://platform.openai.com/docs/api-reference/responses)). This allows you to access **Generect's lead search, company search, email generation**, and other tools directly in **natural language workflows**.

<Note>
  <strong>Two integration methods available:</strong>

  * **[Remote MCP (Custom Connectors)](remote-mcp)** — No installation required, connect via URL or registry ID
  * **Local MCP (this page)** — Uses `npx` to run the MCP server locally
</Note>

The MCP Server is hosted at `https://api.generect.com`. You will use this endpoint on every integration. However, the configuration on different clients has some minor differences.

# Configuration

<Warning>
  In all configurations, don't forget to replace the placeholder API key with your actual key.
</Warning>

## How to use MCP with Claude Desktop?

For remote MCP (no installation), see [Remote MCP (Custom Connectors)](remote-mcp). This page covers local MCP via npx.

Use [Claude Desktop](https://claude.ai/download) and visit **Settings** (click your account icon → **Developer** tab → **Edit config**).

Visit **Settings** in the Claude Desktop app. You can find them in dropdown when click on your account icon. Then navigate to the **Developer** tab, click **Edit config** button

<img src="https://mintcdn.com/generect/9e6ewBZcnqnRB2k9/media/claude-developer-settings2.png?fit=max&auto=format&n=9e6ewBZcnqnRB2k9&q=85&s=1eb99bf8a46f394939ef74889d0d269e" alt="claude-developer-settings" className="rounded-lg" width="1976" height="1578" data-path="media/claude-developer-settings2.png" />

This will show your `claude_desktop_config.json` file:

* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Next, add MCP Server configuration to this file. Replace `your-api-key` with your actual API key. The `Token` prefix is optional — both `your-api-key` and `Token your-api-key` are accepted.

```json theme={null}
{
  "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"
      }
    }
  }
}
```

Restart Claude Desktop to apply changes. After that you will see `generect-api` MCP as active in `Search and tools` dropdown.

After some message where Claude decides to (for example) search leads, you will be prompted to allow the use of external tool.

<img src="https://mintcdn.com/generect/9e6ewBZcnqnRB2k9/media/claude-prompt.png?fit=max&auto=format&n=9e6ewBZcnqnRB2k9&q=85&s=201a0c02f8bc69807a80e27e633baf90" alt="claude-prompt" className="rounded-lg" width="1050" height="776" data-path="media/claude-prompt.png" />

Here is response of example, where Claude automaticlly analyzed LinkedIn profile (some sensitive information was hidden)

<img src="https://mintcdn.com/generect/9e6ewBZcnqnRB2k9/media/response-example.png?fit=max&auto=format&n=9e6ewBZcnqnRB2k9&q=85&s=7671db7fbdd85a4c8fa691163dea2323" alt="response-example" className="rounded-lg" width="1075" height="1280" data-path="media/response-example.png" />

***

## How to use MCP with Cursor?

Use this button to add MCP **directly to Cursor IDE**:

<a href="https://cursor.com/en/install-mcp?name=generect-liveapi&config=eyJjb21tYW5kIjoibm9kZSAuL25vZGVfbW9kdWxlcy90c3gvZGlzdC9jbGkubWpzIHNyYy9zZXJ2ZXIudHMiLCJlbnYiOnsiR0VORVJFQ1RfQVBJX0JBU0UiOiJodHRwczovL2FwaS5nZW5lcmVjdC5jb20iLCJHRU5FUkVDVF9BUElfS0VZIjoiVG9rZW4gPGFwaS1rZXk%2BIiwiR0VORVJFQ1RfVElNRU9VVF9NUyI6IjYwMDAwIn19" target="_blank">
  <img src="https://cursor.com/deeplink/mcp-install-light.svg" alt="Install MCP Server" className="hidden dark:block" noZoom={true} />
</a>

<a href="https://cursor.com/en/install-mcp?name=generect-liveapi&config=eyJjb21tYW5kIjoibm9kZSAuL25vZGVfbW9kdWxlcy90c3gvZGlzdC9jbGkubWpzIHNyYy9zZXJ2ZXIudHMiLCJlbnYiOnsiR0VORVJFQ1RfQVBJX0JBU0UiOiJodHRwczovL2FwaS5nZW5lcmVjdC5jb20iLCJHRU5FUkVDVF9BUElfS0VZIjoiVG9rZW4gPGFwaS1rZXk%2BIiwiR0VORVJFQ1RfVElNRU9VVF9NUyI6IjYwMDAwIn19" target="_blank">
  <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install MCP Server" className="block dark:hidden" noZoom={true} />
</a>

Read [Cursor Docs](https://docs.cursor.com/en/context/mcp) for more info.

# Available Tools

The MCP integration provides access to the following `Generect API` functions:

* `search_leads`: Search for leads by ICP filters
* `search_companies`: Search for companies by ICP filters
* `generate_email`: Generate an email using first/last name and domain
* `get_lead_by_url`: Get LinkedIn lead by profile URL
* `health`: Quick health check against the API