# VoilaNorbert — Pipedream Connect

> Norbert is the ultimate lead generation tool with one of the best success rate to find any corporate email address.

- API slug: `voilanorbert` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: CRM
- Website: https://www.voilanorbert.com
- This page (HTML): https://pipedream.com/apps/voilanorbert
- Tools: 3 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: voilanorbert`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "voilanorbert",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Find Contact:
const result = await mcp.callTool({
  name: "voilanorbert-find-contact",
  arguments: {
    contactId: 10,
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a VoilaNorbert endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.voilanorbert.com/2018-01-08/account/

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkudm9pbGFub3JiZXJ0LmNvbS8yMDE4LTAxLTA4L2FjY291bnQv?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "voilanorbert-find-contact",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    voilanorbert: { authProvisionId: "apn_xxxxxxx" },
    contactId: 10,
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (3)

### `voilanorbert-find-contact` — Find Contact (Read-only)

This action returns a specific contact. The object email is either null when the email is not found, or contains an object with at least email (the email string) and the score. See the docs here

Full schema: https://pipedream.com/apps/voilanorbert/actions/find-contact.md

### `voilanorbert-list-contact-id-options` — List Contact Id Options (Read-only)

Retrieves available options for the Contact Id field.

Full schema: https://pipedream.com/apps/voilanorbert/actions/list-contact-id-options.md

### `voilanorbert-list-list-id-options` — List List ID Options (Read-only)

Retrieves available options for the List ID field.

Full schema: https://pipedream.com/apps/voilanorbert/actions/list-list-id-options.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt