free_people_search
Free on every plan of a signed-in account, also after the trial ends, no credits used.
Free people search by role · Read-only
Free on every plan of a signed-in account, also after the trial ends, no credits used. Finds up to 5 people whose job title contains a role, either at one company (domain) or across companies matching an industry and/or country. Returns name, title, company, domain, seniority, LinkedIn, picture, email and emailStatus. Verified business emails are revealed, up to 10 per account per UTC day across all free tools; personal emails are never returned. emailStatus is 'verified' (address shown), 'unverified — not revealed' or 'daily free limit reached — resets 00:00 UTC' (address masked, e.g. j***@acme.example), or 'not found'. Use free_find_decision_makers for a company's top people without a specific role. Free tools share a limit of 10 calls per account per UTC day (resets 00:00 UTC; past it the call returns 429).
| Connection | Account URL, team member URL or OAuth |
|---|
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
role | string | Yes | Job title or part of it (case-insensitive), e.g. "VP of Sales", "Head of Marketing", "CTO". |
domain | string | No | Optional company domain to search within, e.g. acme.example. When set, industry and country are ignored. |
industry | string | No | Optional industry of the person's company (partial match), e.g. SaaS, FinTech. Used only without domain. |
country | string | No | Optional company headquarters country: ISO code (US, GB) or name. Used only without domain; an unrecognised value is ignored. |
limit | number | No | Max results, 1-5 (default 5). |
Tool definition
What your assistant receives from tools/list:
{
"name": "free_people_search",
"title": "Free people search by role",
"annotations": {
"title": "Free people search by role",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"inputSchema": {
"type": "object",
"properties": {
"role": {
"type": "string",
"description": "Job title or part of it (case-insensitive), e.g. \"VP of Sales\", \"Head of Marketing\", \"CTO\"."
},
"domain": {
"type": "string",
"description": "Optional company domain to search within, e.g. acme.example. When set, industry and country are ignored."
},
"industry": {
"type": "string",
"description": "Optional industry of the person's company (partial match), e.g. SaaS, FinTech. Used only without domain."
},
"country": {
"type": "string",
"description": "Optional company headquarters country: ISO code (US, GB) or name. Used only without domain; an unrecognised value is ignored."
},
"limit": {
"type": "number",
"description": "Max results, 1-5 (default 5)."
}
},
"required": [
"role"
]
}
}