Skip to main content
Glama

Server Details

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

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
The-Face-Analysis/thefaceanalysis-mcp
GitHub Stars
0
Server Listing
thefaceanalysis-mcp
ChatGPT
–
Claude
–

TDQS

A4.6/5.0

Scored across 7 tools

Disambiguation5/5

Each tool has a clearly distinct role: classification, type lookup, type listing, statistics, methodology, citation, and embed generation. The descriptions explicitly cross-reference each other ("use get_face_type instead when..."), and the only potential overlap between classify_face_shape and get_face_type is defused by spelling out that one labels measurements and the other explains a known slug.

Naming Consistency5/5

Five tools use a uniform get_<resource> pattern (get_citation, get_face_type, get_methodology, get_reference_statistics, get_embed_snippet) and the remaining two follow verb_noun with the same snake_case convention (classify_face_shape, list_face_types). No style mixing or vague verbs anywhere.

Tool Count5/5

Seven tools is well within the ideal range and each one earns its place: classification, type discovery/lookup, statistics, methodology, citation, and embed. Nothing looks like filler or a redundant wrapper, and the read-only reference scope makes the small surface appropriate rather than thin.

Completeness4/5

The read-only surface covers the full loop for its stated purpose: discovery (list_face_types), lookup (get_face_type), classification (classify_face_shape), data (get_reference_statistics), provenance (get_citation, get_methodology), and embedding. The one soft gap is that valid measure/group/category values are only revealed through validation errors rather than a dedicated enumeration tool, forcing some trial and error.

Available Tools

7 tools
classify_face_shapeClassify a face shape from four measurementsA
Read-only
Inspect

Runs the same seven-rule face shape classifier as thefaceanalysis.com/face-shape-detector on four distances and returns the shape (oval, round, square, heart, oblong, diamond or triangle), the rule that matched, the four ratios it used, and links to the methodology and detector. Rules are checked in a fixed order (oblong, triangle, round, square, heart, diamond) and oval is the fallback when none match; only ratios matter, so any consistent unit works. Use this when you already have the four distances; it does not look at photos: to measure a photo, use the widget (get_embed_snippet) or the site, and use get_face_type for what a shape means. Borderline faces can flip between two shapes; no accuracy figure is claimed because the reference set has no labelled face types. Read-only; zero, negative or missing values are rejected with a validation error.

Inputs: jaw_width (required), face_length (required), forehead_width (required), cheekbone_width (required).

get_citationHow to cite the dataA
Read-only
Inspect

Returns the citation text, the statistics page URL, the license (CC BY 4.0 for the aggregate numbers), the source photo set (Face Research Lab London Set, with its DOI) and the JSON and CSV download URLs. Use this when quoting or republishing a number from get_reference_statistics or list_face_types; it holds no measurements itself, so use get_methodology instead for how the numbers were made. Takes no parameters; read-only.

Inputs: no named parameters.

get_embed_snippetEmbed code for the face shape widgetA
Read-only
Inspect

Returns paste-ready HTML (a div plus one script tag) that adds the free face shape finder to a web page at the chosen size, with the usage terms and the embed page URL. The widget measures the visitor's photo in their browser, no sign-up and no upload to this server; the terms ask for the visible credit link to stay. Use this when a website owner wants photo measurement on their page; for one person's own photo, point them to thefaceanalysis.com/face-shape-detector instead (this server accepts no photos), and use classify_face_shape when you already have the four distances. Read-only; it only generates text.

Inputs: size.

get_face_typeDescribe one face, eye, lip or nose typeA
Read-only
Inspect

Returns one type's slug, name, page URL, definition, how it is measured from a front photo (the exact threshold rule) and its count and share among the 102 reference faces. Use this when you know the type, e.g. category 'face', slug 'oval'; call list_face_types first if you need the valid slugs, and classify_face_shape to decide which face shape a set of measurements is. Slug matching is case-insensitive; an unknown slug returns an error listing the valid slugs for that category, and an unknown category is rejected with a validation error. Read-only.

Inputs: slug (required), category (required).

get_methodologyMethodology, thresholds and validityA
Read-only
Inspect

Returns how the numbers are made, as one object: the landmark model (478-point MediaPipe) and engine version, every classification threshold (face shape, eye, lip, nose, pupillary distance), how the 1-10 score is built, its validity against 2,513 human raters on the same faces (Spearman correlations with 95% intervals; the score did not predict them) and notes, optionally with the dated change history. Use this to explain or check how a number, threshold or score is computed, or whether the score means anything; use get_reference_statistics for the measured values themselves, get_face_type for one type's rule, and get_citation for how to credit the data. Read-only; the response is large.

Inputs: include_changelog.

get_reference_statisticsFace measurement statisticsA
Read-only
Inspect

Returns percentiles (p10, p25, median, p75, p90, min, max) and the unit 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, plus citation and license. Use this when you need a number (e.g. median fWHR or pupillary distance by sex); use classify_face_shape to label one face's shape, get_face_type for what a type means, and get_methodology for how a measure is computed. Aggregates only; one research set photographed in one city, so these describe these faces, not a population. Read-only; unknown measure or group values are rejected with a validation error.

Inputs: group, measure.

list_face_typesList face, eye, lip and nose typesA
Read-only
Inspect

Lists the types the site's detectors use, grouped by category (face, eye, lip, nose): each with slug, name, page URL and how many of the 102 reference faces it covered (count and share), plus the category hub page. Use this to discover valid slugs or to compare types within a category; use get_face_type instead when you already know the slug and need its definition and threshold rule. The split shows how the detector divides these faces, not how common a type is in a population. Read-only; returns every type in the category, no paging.

Inputs: category.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Creates and manages personality profiles using a 12-facet model based on 33 academic frameworks, stores them as OpenClaw-compatible SOUL.md/IDENTITY.md, and supports progressive profiling with confidence tracking.
      2
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An open-source personality profiling system that enables users to record and analyze their decisions, emotions, and self-reflections through a structured set of 56 tools. It helps users build a digital persona and gain self-insight by tracking interactions, decision-making patterns, and emotional states.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and comparing 45 gem cuts with ray-traced brilliance, fire and scintillation scores across seven gemstones, recommending cuts for a given stone, and fetching 3D models and faceting diagrams. It also serves the Cut Performance Index data for evaluating cut light performance.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables modeling ciliary eye-muscle fatigue and suppressed blink rates, estimating tear-film break-up, scheduling 20-20-20 optical recovery breaks, and calculating Hansraj cervical-spine torque for ergonomic posture remediation.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.