Skip to Content
MCPToolsFind People

Find People

Describe the person you want, get back matching professional profiles from across many companies.

Tool
find_people
Cost
0.3 credits per result
Category
Person Search
Required input
None — pass at least one filter
Returns
Matching professional profiles

What it does

  • Searches people across many companies at once. Data comes from Crustdata.
  • No single parameter is required, but a call with no filters has nothing to search on — pass at least one.
  • Filters stack. Combining role, headcount and location narrows a broad search into a usable list.
  • Returns 25 profiles by default, up to 100 per call. Page through larger result sets with cursor.
  • Cost scales with results — 0.3 credits per profile returned. A default page of 25 costs 7.5 credits; a full page of 100 costs 30.

It returns profiles. It does not return emails or phone numbers — chain find_work_email for those.

To list people at one company you already know, use find_people_within_company instead. It takes a domain and bills a flat 0.3 credits rather than 0.3 per result.


Parameters

Nothing is strictly required. Pass at least one filter from the families below — they are listed in the order the tool accepts them.

Role

ParameterTypeNotes
current_titlesarrayFuzzy match, any-of
exclude_current_titlesarrayDrops profiles holding these titles
past_titlesarrayTitles held in a previous role
seniority_levelsarrayc_suite, vp, director, senior
current_functionsarrayEngineering, Sales, Marketing

Company

ParameterTypeNotes
current_company_namesarrayExact match
current_company_domainsarrayMore reliable than names
past_company_namesarrayWorked there previously
past_company_domainsarrayWorked there previously
current_company_typesarrayPublic Company, Privately Held
current_company_countriesarrayCompany country, not person country
industriesarrayIndustry of the current company

Company size

ParameterTypeNotes
current_company_headcount_rangesarray1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
min_current_company_headcountnumberUse instead of ranges for a custom floor
max_current_company_headcountnumberUse instead of ranges for a custom ceiling

Location

ParameterTypeNotes
person_countriesarrayExact match
person_locationsarrayFuzzy match — cities, regions

Tenure and experience

ParameterTypeNotes
min_years_at_current_companynumberTime in the current seat
max_years_at_current_companynumberTime in the current seat
min_years_experiencenumberTotal career experience
max_years_experiencenumberTotal career experience

Education

ParameterTypeNotes
schoolsarrayFuzzy match
degreesarrayFuzzy match
fields_of_studyarrayFuzzy match

Skills

ParameterTypeNotes
skillsarrayAny-of — a profile matching one skill matches

Network

ParameterTypeNotes
min_followersnumberLinkedIn follower count
max_followersnumberLinkedIn follower count
min_connectionsnumberLinkedIn connection count
max_connectionsnumberLinkedIn connection count

Signals

ParameterTypeNotes
recently_changed_jobsbooleanOnly people who moved recently
has_verified_business_emailbooleanOnly profiles with a verified business email
open_tostringCAREER_INTEREST, HIRING_MANAGER, VOLUNTEERING

Paging

ParameterTypeNotes
limitnumber1–100, default 25
cursorstringPass the next_cursor from the previous call

How to use it

Connect the MCP server

Follow the setup guide for your client. Browser sign-in, no API key.

Find VP Sales and Head of Sales at Privately Held SaaS companies with 51-200 employees in the United States. Limit 25.

Tighten the filters

Same search, but only people who have been in the role at least 1 year and have a verified business email.

Page through the rest

Get the next page using the cursor from that result. Stop after 3 pages and tell me how many credits you used.

Enrich the ones you want

For the 10 best matches, find work emails and verify them.

Example prompts

Ask your clientWhat you get back
”Find c_suite people at fintech companies with 201-500 employees”Profiles matching seniority, industry and headcount
”Find RevOps directors in Germany who changed jobs recently”Role, country and recently_changed_jobs combined
”Find engineers with Kubernetes skills who studied at MIT”Skills plus education filters
”Find people at stripe.com and shopify.com with VP titles”Multi-company search by domain
”Find CTOs at stripe.com”Better served by find_people_within_company — one company, flat 0.3 credits

Best prompting practices

  • Always pass a filter. A search with nothing to match on still bills 0.3 credits for every profile it returns, and returns noise.
  • Use domains, not company names. current_company_domains is exact. Names are easy to get wrong.
  • Use the exact enum strings. c_suite and vp are the accepted seniority values — “C-level” and “Vice President” are not.
  • Set limit deliberately. limit is the cost dial — every profile returned is 0.3 credits. Ask for the number you will actually work, not the maximum.
  • Cap the paging. “Stop after 3 pages” prevents a broad search from walking the whole result set. Three pages of 100 is 300 profiles and 90 credits.
  • Search first, enrich second. Filter down to the profiles you want before spending credits on emails or phones.

Output

{ "profiles": [ { "name": "Jane Doe", "title": "VP Sales", "company": "Stripe", "location": "San Francisco, United States", "linkedin_url": "https://linkedin.com/in/janedoe" } ], "next_cursor": "eyJwYWdlIjoyfQ" }

Credits and limits

0.3 credits per profile returned. limit accepts 1–100 and defaults to 25, so a default call costs 7.5 credits and a full page costs 30. Each extra page fetched with cursor bills the same way.

Run check_credits (free) before a long paging run.

Broad filter sets return large, loose result sets — and you pay 0.3 credits for every loose match. Test a filter combination with limit: 25 before you page through it.


ToolUse it instead when
find_people_within_companyYou already know the one company — flat 0.3 credits, takes a domain
find_companiesYou want the accounts first, people second
newly_hired_executivesYou want recent hires at a company, with their previous role
enrich_personYou already have an identifier and want one contact record

Next steps


Keep learning

Two courses take these tools past the reference page — clustered by GTM job, then chained into workflows.