Tools · Search people
search_people
Describe who you want, or name the companies. Get names, titles and LinkedIn profiles, ranked by fit.
When to use
Use it for people: from a brief (q, plus titles), the holders of titles at chosen companies (companies + titles), or one named person (full_name).
Don’t use it to list companies (use search_companies or common_investors).
Request
curl https://lead-search-production.up.railway.app/v1/search_people \
-H "Authorization: Bearer $MUNCH_KEY" \
-d '{"q": "Heads of Growth at Series A fintechs in New York",
"titles": ["Head of Growth"], "limit": 20}'
Over MCP, your agent fills these parameters from your request.
Parameters
All optional. Give at least one search criterion.
qstringYour brief in one plain sentence: role + kind of company + place, e.g. "CTOs at fintech startups in London".
companiesstring[]Domains of companies already chosen, e.g. ["stripe.com"]: returns the holders of `titles` there.
company_descriptionstringThe kind of company, e.g. "insurtech startups selling to insurers".
company_domainstringOne company, e.g. "stripe.com"; same as companies.
countrystringISO-2 country: rows located elsewhere are dropped.
cursorstring`next_cursor` from the previous answer, with exactly the same criteria: continues where it stopped, without fetching the same people again.
full_namestringLook up one named person (a single routed call).
keywordsstring[]Skills or topics, e.g. ["developer advocacy"]: each person is matched against them with the brief, so people far from them are left out.
limitintegerPeople wanted. The search keeps fetching until this many pass the checks.
locationstringFree text, e.g. "San Francisco Bay Area".
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 detailedtitlestringOne job title; prefer titles.
titlesstring[]The role and its usual variants, e.g. ["Head of Data", "Chief Data Officer", "VP Data"], in the order of preference you gave.
Response
budget_left_today_usdnumberWhat this key may still spend today (daily cap, resets 00:00 UTC); absent when uncapped
cost_usdnumbernext_cursorstringPass back as `cursor` with the same criteria to continue without fetching the same people again
notesstring[]Plain-language notes for the user: what was found, what could not be confirmed, and what to do next
peoplePersonRow[]people[] fields
companystringcompany_domainstringemailstringOnly when one was found; an unverified guess
linkedin_urlstringlocationstringnamestringperson_idstringPass to find_contacts to get this person's email or phone
rolestring'ceo', 'cto', 'founder' (another founder) or 'other'; a founder/CEO search lists the CEO first
summarystringHeadline and experience as found, trimmed
titlestring