analyze_faces

Analyze faces in an image. Detects each face and returns its location, confidence score, facial landmarks (eyes, nose, mouth), and head orientation. Optionally computes liveness/spoof detection, passport-standard (ICAO) quality checks, cropped face thumbnails, and detailed analytics including age, emotion, geographic origin, gender, glasses, facial hair, head pose, mouth open/closed, face and image quality, artwork detection, and mask detection. Provide the image as base64 (preferred) or a public URL as fallback.

Parameters7

image_base64	string	optional	Base64-encoded image (jpg, png, bmp). Preferred over image_url.
image_url	string	optional	Public URL of the image. Used only if image_base64 is not provided.
analytics	boolean	optional	Compute face analytics including: age estimation, emotion classification (anger, disgust, fear, joy, neutral, sadness, surprise), geographic origin (African, East Asian, European, Latin American, Middle Eastern, South Asian, Southeast Asian), gender, glasses detection (eye, sun, none), facial hair, head pose (yaw, pitch, roll), mouth open, face quality/matchability, image quality, artwork detection (human, cartoon, painting), and mask detection.
icao_metrics	boolean	optional	Check whether the face photo meets passport and ID standards (ICAO), including eye visibility, glare, lighting, occlusion, and overall image quality.
spoof	boolean	optional	Detect whether the face is from a live person or a photo of a photo. Returns a liveness score between 0.0 and 1.0 where higher values indicate a greater chance of a spoof.
thumbnail	boolean	optional	Generate an aligned and cropped base64 JPG face image suitable for displaying. If combined with icao_background, the thumbnail will be a base64 PNG with the background removed.
icao_background	boolean	optional	Compute ICAO uniform background face portrait quality metric. If combined with thumbnail, the thumbnail will be a base64 PNG with the background removed.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "Base64-encoded image (jpg, png, bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "Public URL of the image. Used only if image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "analytics": {
      "description": "Compute face analytics including: age estimation, emotion classification (anger, disgust, fear, joy, neutral, sadness, surprise), geographic origin (African, East Asian, European, Latin American, Middle Eastern, South Asian, Southeast Asian), gender, glasses detection (eye, sun, none), facial hair, head pose (yaw, pitch, roll), mouth open, face quality/matchability, image quality, artwork detection (human, cartoon, painting), and mask detection.",
      "type": "boolean"
    },
    "icao_metrics": {
      "description": "Check whether the face photo meets passport and ID standards (ICAO), including eye visibility, glare, lighting, occlusion, and overall image quality.",
      "type": "boolean"
    },
    "spoof": {
      "description": "Detect whether the face is from a live person or a photo of a photo. Returns a liveness score between 0.0 and 1.0 where higher values indicate a greater chance of a spoof.",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Generate an aligned and cropped base64 JPG face image suitable for displaying. If combined with icao_background, the thumbnail will be a base64 PNG with the background removed.",
      "type": "boolean"
    },
    "icao_background": {
      "description": "Compute ICAO uniform background face portrait quality metric. If combined with thumbnail, the thumbnail will be a base64 PNG with the background removed.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_faces

Check if the same person appears in two different images. Finds all faces in both images and compares each face from the first image against each face in the second. Returns only the pairs that match, with a similarity score between 0.0 and 1.0. Provide each image as base64 (preferred) or a public URL as fallback.

Parameters5

image_a_base64	string	optional	Base64-encoded first image (jpg, png, bmp). Preferred over image_a_url.
image_a_url	string	optional	Public URL of the first image. Used only if image_a_base64 is not provided.
image_b_base64	string	optional	Base64-encoded second image (jpg, png, bmp). Preferred over image_b_url.
image_b_url	string	optional	Public URL of the second image. Used only if image_b_base64 is not provided.
threshold	number	optional	Minimum similarity score for a pair to be considered a match. Defaults to 0.5 (approximately one-in-ten-million false match rate). Only pairs at or above this value are returned.

Raw schema

{
  "type": "object",
  "properties": {
    "image_a_base64": {
      "description": "Base64-encoded first image (jpg, png, bmp). Preferred over image_a_url.",
      "type": "string"
    },
    "image_a_url": {
      "description": "Public URL of the first image. Used only if image_a_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "image_b_base64": {
      "description": "Base64-encoded second image (jpg, png, bmp). Preferred over image_b_url.",
      "type": "string"
    },
    "image_b_url": {
      "description": "Public URL of the second image. Used only if image_b_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "threshold": {
      "description": "Minimum similarity score for a pair to be considered a match. Defaults to 0.5 (approximately one-in-ten-million false match rate). Only pairs at or above this value are returned.",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

analyze_license_plates

Analyze license plates in an image. Detects each license plate and returns its location, confidence score, and recognized text (ALPR/OCR). Optionally classifies the issuing region (e.g. state or country), filters non-compliant text, ignores partial reads, and returns a cropped base64 JPG thumbnail of the plate. Provide the image as base64 (preferred) or a public URL as fallback.

Parameters6

image_base64	string	optional	Base64-encoded image (jpg, png, bmp). Preferred over image_url.
image_url	string	optional	Public URL of the image. Used only if image_base64 is not provided.
region	string	optional	Geographic region for plate classification (issuing state/country). One of: north_american, european, pacific, south_american, asian, middle_eastern, african. Omit to skip classification.
filter_text	boolean	optional	Filter out non-compliant text results that do not match a known license plate pattern.
ignore_partial	boolean	optional	Ignore partial license plate detections that fall outside the image bounds.
thumbnail	boolean	optional	Generate an aligned and cropped base64 JPG thumbnail of the license plate suitable for displaying.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "Base64-encoded image (jpg, png, bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "Public URL of the image. Used only if image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "region": {
      "description": "Geographic region for plate classification (issuing state/country). One of: north_american, european, pacific, south_american, asian, middle_eastern, african. Omit to skip classification.",
      "type": "string"
    },
    "filter_text": {
      "description": "Filter out non-compliant text results that do not match a known license plate pattern.",
      "type": "boolean"
    },
    "ignore_partial": {
      "description": "Ignore partial license plate detections that fall outside the image bounds.",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Generate an aligned and cropped base64 JPG thumbnail of the license plate suitable for displaying.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_text

Read text in an image (OCR). Detects each text region and returns its location, confidence score, and recognized text. Optionally restricts results to a regex pattern, restricts allowed characters via a vocabulary, ignores partial detections, and returns a cropped base64 JPG thumbnail of each text region. Provide the image as base64 (preferred) or a public URL as fallback.

Parameters6

image_base64	string	optional	Base64-encoded image (jpg, png, bmp). Preferred over image_url.
image_url	string	optional	Public URL of the image. Used only if image_base64 is not provided.
text_filter	string	optional	Regular expression that recognized text must match. Non-matching detections are discarded.
text_vocabulary	string	optional	Set of allowed characters for OCR. Only characters in this string will be returned.
ignore_partial	boolean	optional	Ignore partial text detections that fall outside the image bounds.
thumbnail	boolean	optional	Generate an aligned and cropped base64 JPG thumbnail of each text region suitable for displaying.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "Base64-encoded image (jpg, png, bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "Public URL of the image. Used only if image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "text_filter": {
      "description": "Regular expression that recognized text must match. Non-matching detections are discarded.",
      "type": "string"
    },
    "text_vocabulary": {
      "description": "Set of allowed characters for OCR. Only characters in this string will be returned.",
      "type": "string"
    },
    "ignore_partial": {
      "description": "Ignore partial text detections that fall outside the image bounds.",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Generate an aligned and cropped base64 JPG thumbnail of each text region suitable for displaying.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

detect_persons

Find people in a photo. Returns the position and confidence score for each person found, along with body landmarks and clothing color. Can also return a cropped image of each person. Provide the image as base64 (preferred) or a public URL.

Parameters4

image_base64	string	optional	The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.
image_url	string	optional	A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.
ignore_partial	boolean	optional	Skip people who are only partially visible (cut off by the edge of the image).
thumbnail	boolean	optional	Return a small cropped image of each detected person.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "ignore_partial": {
      "description": "Skip people who are only partially visible (cut off by the edge of the image).",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Return a small cropped image of each detected person.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

detect_vehicles

Find vehicles in a photo. Returns the position and confidence score for each vehicle found, along with its predicted make, model, and color. Can also return a cropped image of each vehicle. Provide the image as base64 (preferred) or a public URL.

Parameters4

image_base64	string	optional	The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.
image_url	string	optional	A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.
ignore_partial	boolean	optional	Skip vehicles that are only partially visible (cut off by the edge of the image).
thumbnail	boolean	optional	Return a small cropped image of each detected vehicle.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "ignore_partial": {
      "description": "Skip vehicles that are only partially visible (cut off by the edge of the image).",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Return a small cropped image of each detected vehicle.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

detect_guns

Find guns in a photo. Returns the position and confidence score for each gun found. Can also return a cropped image of each gun. Provide the image as base64 (preferred) or a public URL.

Parameters4

image_base64	string	optional	The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.
image_url	string	optional	A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.
ignore_partial	boolean	optional	Skip guns that are only partially visible (cut off by the edge of the image).
thumbnail	boolean	optional	Return a small cropped image of each detected gun.

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "description": "The image encoded as a base64 string (jpg, png, or bmp). Preferred over image_url.",
      "type": "string"
    },
    "image_url": {
      "description": "A publicly accessible URL pointing to the image. Used only when image_base64 is not provided.",
      "type": "string",
      "format": "uri"
    },
    "ignore_partial": {
      "description": "Skip guns that are only partially visible (cut off by the edge of the image).",
      "type": "boolean"
    },
    "thumbnail": {
      "description": "Return a small cropped image of each detected gun.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ai.roc/mcp

ai.roc/mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

analyze_faces

compare_faces

analyze_license_plates

read_text

detect_persons

detect_vehicles

detect_guns

Install

Remote endpoint

Related servers