Tools · Find contact details

find_contacts

Get the work email or phone of people you already found. You pay only for what is found.

read-only≤ 45 s$0.001–$0.05 / email

When to use

Use it for the work email or phone number of people already found (rows from search_people or search_intent_people, by their `person_id`) or of LinkedIn profiles they give.

Don’t use it to find people (search first).

Request

POST /v1/find_contacts
curl https://lead-search-production.up.railway.app/v1/find_contacts \
  -H "Authorization: Bearer $MUNCH_KEY" \
  -d '{"people": ["p1.…", "p1.…"], "fields": ["email"]}'

Over MCP, your agent fills these parameters from your request.

Parameters

Give people and fields.

cursorstring

`next_cursor` from the previous answer, with the same fields: looks up the people not done yet.

fieldsstring[]

What to look up, as you asked: ["email"] (work email), ["phone"] (direct or mobile), or both. Required: nothing is looked up by default.

email phone
peoplestring[]up to 25 items

The `person_id` of rows from search_people or search_intent_people (no search runs again), or LinkedIn profile URLs (https://www.linkedin.com/in/<name>).

response_formatstringdefault "concise"

"concise" (default): the fields needed to pick and act on rows. "detailed": every field (LinkedIn URLs, descriptions, industries); about 3-5x the tokens.

concise detailed

Response

budget_left_today_usdnumber

What this key may still spend today (daily cap, resets 00:00 UTC); absent when uncapped

contactsContactRow[]
cost_usdnumber
next_cursorstring

People not looked up yet: pass back as `cursor` with the same fields

notesstring[]

Plain-language notes for the user: what was found, what could not be confirmed, and what to do next

contacts[] fields

companystring
company_domainstring
emailstring

Work email, when one was found

email_confidencestring

'high' (two sources, or mailbox confirmed), 'medium' or 'low' (likely a guess)

email_statusstring

'valid' (the mailbox accepts mail), 'catch_all' (the server accepts any address), 'unverified', 'not_found' or 'not_checked' (not looked up now: try again)

linkedin_urlstring
namestring
person_idstring
phonestring
phone_countrystring
phone_statusstring

When phone was asked: 'found', 'not_found', or 'not_checked' (could not be looked up now: nothing charged, try again)

phone_typestring

mobile, landline... when known

Errors: Errors. Limits: Limits.