# free_people_search (/docs/mcp/free-tools/free-people-search)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/free_people_search.mdx. */}

**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 [#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 [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "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"
    ]
  }
}
```