get_board_vacancies
Get current board vacancies scraped from Appoint Better Boards and IoD NZ. Filterable by source, sector, region, and remuneration type. Optionally returns candidate matches for a specific vacancy.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_board_vacancies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 20) | |
| region | No | Filter by NZ region (e.g. "Auckland", "Wellington", "Canterbury") | |
| sector | No | Filter by sector (e.g. "Health", "Charity/NFP", "Government") | |
| source | No | Filter by source: "appoint" (Appoint Better Boards) or "iod" (IoD NZ) | |
| vacancy_id | No | Get details + candidate matches for a specific vacancy ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or "none found". | |
| meta | Yes | ||
| tool | Yes | Tool that produced this result. | |
| schema_version | Yes | Envelope contract version. Bumps only on a breaking shape change. |