TheFaceAnalysis

com.thefaceanalysis/face-analysis · v0.1.0 · data-and-databases

TheFaceAnalysis is healthy: it completed an MCP handshake in 965 ms and exposes 7 tools.

Face shape rules and a 102-face open measurement dataset. Read-only, no photos.

Endpoint: https://mcp.thefaceanalysis.com/mcp (streamable-http)

Repository · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count7
Latency965 ms
Last checked (UTC)2026-10-26T18:05:11.673Z

Health history

Checked (UTC)StatusLatencyError
2026-10-26T18:05:11.673ZHealthy965

Tools (7)

get_reference_statisticsPercentiles (p10, p25, median, p75, p90, min, max) of facial measurements from 102 adult faces (49 women, 53 men) of the Face Research Lab London Set, measured with a 478-point MediaPipe landmarker. Measures: composite score, symmetry, golden ratio fit, fWHR, midface ratio, pupillary distance, canth
list_face_typesLists the types the site's detectors use, with slug, name, page URL and how many of the 102 reference faces each type covered. The split shows how the detector divides these faces, not how common a type is in a population.
get_face_typeDefinition and how the type is measured from a front photo (the exact threshold rule), plus its page URL. Example: category 'face', slug 'oval'.
classify_face_shapeRuns the same seven-rule face shape classifier as thefaceanalysis.com/face-shape-detector on four distances (any consistent unit: pixels, mm or landmark units). Returns the shape, the rule that matched and the four ratios. It does not look at photos: to measure a photo, use the widget (get_embed_sni
get_methodologyHow the numbers are made: the landmark model, every classification threshold, how the 1-10 score is built, and how it correlated with 2,513 human raters on the same faces (it did not predict them). Includes the method change history.
get_citationCitation text, license (CC BY 4.0 for the aggregate numbers) and the source photo set. Use when quoting a number.
get_embed_snippetHTML a website owner can paste to add the free face shape finder (it measures the visitor's photo in their browser, no sign-up). Includes the visible credit link the terms ask for.