# Tomba — Pipedream Connect

> Tomba is the leading solution to find and verify professional email addresses. Start using Tomba and connect with the people that matter for your business.

- API slug: `tomba` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: CRM
- Website: https://tomba.io/
- This page (HTML): https://pipedream.com/apps/tomba
- Tools: 20 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: tomba`

```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": "tomba",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// e.g. run Enrich Email:
const result = await mcp.callTool({
  name: "tomba-enrich-email",
  arguments: {
    email: "Email Address",
  },
})
```

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

## API proxy

For a Tomba 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.tomba.io/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkudG9tYmEuaW8vdjEvbWU?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: "tomba-enrich-email",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    tomba: { authProvisionId: "apn_xxxxxxx" },
    email: "Email Address",
  },
})
```

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

## Actions (20)

### `tomba-enrich-email` — Enrich Email (Read-only)

Look up person and company data based on an email. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/enrich-email.md

### `tomba-find-author` — Find Author (Read-only)

Generate or retrieve the most likely email address from a blog post URL. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/find-author.md

### `tomba-find-email` — Find Email (Read-only)

Generate or retrieve the most likely email address from a domain name, a first name and a last name. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/find-email.md

### `tomba-find-linkedin-email` — Find LinkedIn Email (Read-only)

Generate or retrieve the most likely email address from a LinkedIn URL. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/find-linkedin-email.md

### `tomba-find-phone` — Find Phone (Read-only)

Search for phone numbers based on an email, domain, or LinkedIn URL. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/find-phone.md

### `tomba-find-similar-domains` — Find Similar Domains (Read-only)

Retrieve similar domains based on a specific domain. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/find-similar-domains.md

### `tomba-get-account` — Get Account (Read-only)

Returns information about the current account including usage statistics and plan details. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-account.md

### `tomba-get-domain-status` — Get Domain Status (Read-only)

Find domain status if is webmail or disposable. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-domain-status.md

### `tomba-get-domain-suggestions` — Get Domain Suggestions (Read-only)

Retrieve a list of suggested domains similar to or related to your search query. This helps discover competitors, similar companies, and related businesses for market research and prospecting. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-domain-suggestions.md

### `tomba-get-email-count` — Get Email Count (Read-only)

Find total email addresses we have for one domain. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-email-count.md

### `tomba-get-email-format` — Get Email Format (Read-only)

Retrieve the email format patterns used by a specific domain. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-email-format.md

### `tomba-get-email-sources` — Get Email Sources (Read-only)

Find email address source somewhere on the web. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-email-sources.md

### `tomba-get-location` — Get Location (Read-only)

Get employees location based on the domain name. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-location.md

### `tomba-get-logs` — Get Logs (Read-only)

Retrieve API request logs for your account with pagination support. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-logs.md

### `tomba-get-technology` — Get Technology (Read-only)

Retrieve the technologies used by a specific domain. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-technology.md

### `tomba-get-usage` — Get Usage (Read-only)

Retrieve API usage statistics and quota information for your account. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/get-usage.md

### `tomba-search-companies` — Search Companies (Read-only)

Search for companies using natural language queries or structured filters. The AI assistant will automatically generate appropriate filters from your query. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/search-companies.md

### `tomba-search-domain` — Search Domain (Read-only)

Get every email address found on the internet using a given domain name, with sources. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/search-domain.md

### `tomba-validate-phone` — Validate Phone (Read-only)

Validate a phone number and retrieve its associated information. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/validate-phone.md

### `tomba-verify-email` — Verify Email (Read-only)

Verify the deliverability of an email address. See the documentation

Full schema: https://pipedream.com/apps/tomba/actions/verify-email.md

---

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