Tools · Find contact details
find_contacts
Get the work email or phone of people you already found. You pay only for what is found.
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
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 phonepeoplestring[]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_formatstring"concise" (default): the fields needed to pick and act on rows. "detailed": every field (LinkedIn URLs, descriptions, industries); about 3-5x the tokens.
concise detailedResponse
budget_left_today_usdnumberWhat this key may still spend today (daily cap, resets 00:00 UTC); absent when uncapped
contactsContactRow[]cost_usdnumbernext_cursorstringPeople 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
companystringcompany_domainstringemailstringWork 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_urlstringnamestringperson_idstringphonestringphone_countrystringphone_statusstringWhen phone was asked: 'found', 'not_found', or 'not_checked' (could not be looked up now: nothing charged, try again)
phone_typestringmobile, landline... when known