detect_faces
Detect human faces in a local image and return their positions as percentages of image dimensions. Works offline using Apple Vision.
Instructions
Detect human faces in a local image file using Apple Vision (offline, no API key needed).
USE WHEN: The user wants to know how many faces are in a local image, or needs their positions. DO NOT USE for: text extraction (use ocr_image), barcode reading (use detect_barcodes).
Returns: JSON with the total face count and an array of face positions expressed as percentage of image dimensions (top, left, width, height).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "detect_faces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute or relative path to the image file |