thefaceanalysis-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port used by the self-hosted HTTP transport (POST /mcp, stateless). Example: npm run build && PORT=8787 npm run start:http |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_reference_statisticsA | Percentiles (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, canthal tilt. Aggregates only; one research set photographed in one city, so these describe these faces, not a population. |
| list_face_typesA | Lists 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_typeA | Definition 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_shapeA | Runs 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_snippet) or the site. Borderline faces can flip between two shapes; no accuracy figure is claimed because the reference set has no labelled face types. |
| get_methodologyB | How 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_citationA | Citation text, license (CC BY 4.0 for the aggregate numbers) and the source photo set. Use when quoting a number. |
| get_embed_snippetA | HTML 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools target clearly distinct resources: reference stats, type listing, type definition, classification, methodology, citation, and embed snippet. The main overlap is between get_reference_statistics and get_methodology, both of which describe how the numbers are produced, and list_face_types vs get_face_type are closely related, but descriptions differentiate them adequately.
All names use snake_case with a predictable verb_noun pattern (get_reference_statistics, list_face_types, get_face_type, classify_face_shape, get_methodology, get_citation, get_embed_snippet). The single 'classify_' variant is still a clear verb fitting the pattern.
Seven tools is well-scoped for a reference/measurement server, with each tool covering a distinct facet (data, types, classification, methodology, citation, embed). No tool appears redundant or bloated.
The surface covers statistics, type taxonomy, classification, methodology, citation, and an embed path, which is solid for the domain. Minor gaps exist: there is no tool to compute or look up per-face measures like symmetry, golden ratio, or fWHR that the reference statistics mention.