HappierleadsDocs
MCP server

reveal_contact

Returns the email address and phone number held for one person from search_people.

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.

ConnectionAccount URL, team member URL or OAuth

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

Reveal the emails for the first five.

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

ParameterTypeRequiredDescription
websiteIdstringYesWebsite ID from list_websites (the same one used for search_people).
profileIdstringYesprofileId from a search_people row.

Tool definition

What your assistant receives from tools/list:

{
  "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

On this page