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
| Parameter | Type | Notes |
|---|---|---|
current_titles | array | Fuzzy match, any-of |
exclude_current_titles | array | Drops profiles holding these titles |
past_titles | array | Titles held in a previous role |
seniority_levels | array | c_suite, vp, director, senior |
current_functions | array | Engineering, Sales, Marketing |
Company
| Parameter | Type | Notes |
|---|---|---|
current_company_names | array | Exact match |
current_company_domains | array | More reliable than names |
past_company_names | array | Worked there previously |
past_company_domains | array | Worked there previously |
current_company_types | array | Public Company, Privately Held |
current_company_countries | array | Company country, not person country |
industries | array | Industry of the current company |
Company size
| Parameter | Type | Notes |
|---|---|---|
current_company_headcount_ranges | array | 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
min_current_company_headcount | number | Use instead of ranges for a custom floor |
max_current_company_headcount | number | Use instead of ranges for a custom ceiling |
Location
| Parameter | Type | Notes |
|---|---|---|
person_countries | array | Exact match |
person_locations | array | Fuzzy match — cities, regions |
Tenure and experience
| Parameter | Type | Notes |
|---|---|---|
min_years_at_current_company | number | Time in the current seat |
max_years_at_current_company | number | Time in the current seat |
min_years_experience | number | Total career experience |
max_years_experience | number | Total career experience |
Education
| Parameter | Type | Notes |
|---|---|---|
schools | array | Fuzzy match |
degrees | array | Fuzzy match |
fields_of_study | array | Fuzzy match |
Skills
| Parameter | Type | Notes |
|---|---|---|
skills | array | Any-of — a profile matching one skill matches |
Network
| Parameter | Type | Notes |
|---|---|---|
min_followers | number | LinkedIn follower count |
max_followers | number | LinkedIn follower count |
min_connections | number | LinkedIn connection count |
max_connections | number | LinkedIn connection count |
Signals
| Parameter | Type | Notes |
|---|---|---|
recently_changed_jobs | boolean | Only people who moved recently |
has_verified_business_email | boolean | Only profiles with a verified business email |
open_to | string | CAREER_INTEREST, HIRING_MANAGER, VOLUNTEERING |
Paging
| Parameter | Type | Notes |
|---|---|---|
limit | number | 1–100, default 25 |
cursor | string | Pass 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.
Start with a narrow search
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 client | What 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_domainsis exact. Names are easy to get wrong. - Use the exact enum strings.
c_suiteandvpare the accepted seniority values — “C-level” and “Vice President” are not. - Set
limitdeliberately.limitis 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.
Related tools
| Tool | Use it instead when |
|---|---|
find_people_within_company | You already know the one company — flat 0.3 credits, takes a domain |
find_companies | You want the accounts first, people second |
newly_hired_executives | You want recent hires at a company, with their previous role |
enrich_person | You already have an identifier and want one contact record |
Next steps
- All MCP tools — the full catalogue with credit costs
- MCP use cases — search-to-outreach workflows
- AI for Sales Reps — workflows that chain this tool into a list build
Keep learning
Two courses take these tools past the reference page — clustered by GTM job, then chained into workflows.