About TheFaceAnalysis
TheFaceAnalysis is a read-only MCP server that provides sourced facial measurement data and the classifier used by its website. It is intended for assistants needing citable reference statistics and rule-based face-type results; it does not accept photos.
Key features
- 01Reference statistics from 102 faces
- 02Definitions and threshold rules for face types
- 03Classify face shape from four distances
- 04Explain scoring methodology and validation context
- 05Provide citations, licensing, and dataset downloads
- 06Return an embeddable face-shape widget snippet
Use cases
- 01Retrieve citable facial measurement statistics
- 02Check the threshold behind a face-type label
- 03Classify a face shape from measured distances
MCP support
Exposes read-only tools for statistics, face-type rules, shape classification, methodology, citations, and an embed snippet. It does not process photos.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.thefaceanalysis.com/mcpclaude mcp add --transport http com-thefaceanalysis-face-analysis https://mcp.thefaceanalysis.com/mcp{"mcpServers":{"com-thefaceanalysis-face-analysis":{"type":"http","url":"https://mcp.thefaceanalysis.com/mcp"}}}Open in Cursor{"servers":{"com-thefaceanalysis-face-analysis":{"type":"http","url":"https://mcp.thefaceanalysis.com/mcp"}}}Open in VS Code{"mcpServers":{"com-thefaceanalysis-face-analysis":{"type":"http","url":"https://mcp.thefaceanalysis.com/mcp"}}}{"mcpServers":{"com-thefaceanalysis-face-analysis":{"serverUrl":"https://mcp.thefaceanalysis.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEthefaceanalysis-mcp
MCP server for The Face Analysis. It gives an AI assistant sourced, citable face measurement data and the same face shape classifier the site uses. Read-only; it takes no photo.
Tools
| Tool | What it returns |
|---|---|
get_reference_statistics | Percentiles of fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance, canthal tilt on 102 faces (all / women / men) |
list_face_types, get_face_type | Face, eye, lip and nose types: definition and the exact threshold rule |
classify_face_shape | Face shape from four distances, using the site's seven rules in the site's order |
get_methodology | Thresholds, how the score is built, validity against 2,513 raters, change history |
get_citation | Citation text, CC BY 4.0 license, source photo set, downloads |
get_embed_snippet | HTML to put the free face shape widget on a page |
To measure a photo, use https://thefaceanalysis.com/face-shape-detector (free, runs in the browser, no sign-up) or the embeddable widget.
Use
Hosted (no install): add https://mcp.thefaceanalysis.com/mcp as a remote MCP server in your client. Setup guide: https://thefaceanalysis.com/mcp
Local:
{ "mcpServers": { "thefaceanalysis": { "command": "npx", "args": ["-y", "thefaceanalysis-mcp"] } } }
Self-host the HTTP transport: npm run build && PORT=8787 npm run start:http (POST /mcp, stateless).
Honest limits
102 faces from one research set (Face Research Lab London Set), photographed in one city in one month: the numbers describe these faces, not a population. Face type splits show how the detector divides these faces, not how common a type is. No accuracy figure is claimed for any type label. Details: https://thefaceanalysis.com/methodology
Data CC BY 4.0, code MIT.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.