# reveal_contact (/docs/mcp/tools/reveal-contact)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/reveal_contact.mdx. */}

**Reveal contact details** · Changes data · Spends credits or money

Returns the email address and phone number held for one person from search_people. Use it when the row shows hasEmail or hasPhone true. When neither is held, use find_contact_email to search for an address. Costs 1 credit when an email or phone is held. When nothing is held it costs 0 and returns status 'no-contact-details' with a hint. Returns 402 'Insufficient credits' when the account is out of credits. Confirm with the user before calling. Returns businessEmail, emailStatus, phone, creditsCharged, status and remainingCredits.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## When to use it [#when-to-use-it]

After `search_people`, when you want the email and phone of specific people. Pass the `profileId` from a search row.

## Try asking [#try-asking]

> Reveal the emails for the first five.

## Good to know [#good-to-know]

- **1 credit per person,** and nothing when we hold no details. Check `hasEmail` / `hasPhone` on the search row first.
- One person per call: revealing 25 people is 25 calls and up to 25 credits. Turn on tool approval if you want to confirm each one.
- No email held? `find_contact_email` looks for one, but costs 50 or 100 credits **even when it finds nothing**. Ask before using it.

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites (the same one used for search_people). |
| `profileId` | `string` | Yes | profileId from a search_people row. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "reveal_contact",
  "title": "Reveal contact details",
  "annotations": {
    "title": "Reveal contact details",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites (the same one used for search_people)."
      },
      "profileId": {
        "type": "string",
        "description": "profileId from a search_people row."
      }
    },
    "required": [
      "websiteId",
      "profileId"
    ]
  }
}
```

## Used in [#used-in]

- [/docs/leads/prospector/search-prospects/manual-search/mcp](/docs/leads/prospector/search-prospects/manual-search/mcp)