English Français العربية

TheFaceAnalysis

Official registry Data and databases

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http thefaceanalysis 'https://mcp.thefaceanalysis.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "thefaceanalysis": {
            "type": "http",
            "url": "https://mcp.thefaceanalysis.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. thefaceanalysis-mcp
  2. Tools
  3. Use
  4. Honest limits

thefaceanalysis-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

ToolWhat it returns
get_reference_statisticsPercentiles of fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance, canthal tilt on 102 faces (all / women / men)
list_face_types, get_face_typeFace, eye, lip and nose types: definition and the exact threshold rule
classify_face_shapeFace shape from four distances, using the site's seven rules in the site's order
get_methodologyThresholds, how the score is built, validity against 2,513 raters, change history
get_citationCitation text, CC BY 4.0 license, source photo set, downloads
get_embed_snippetHTML 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.

Frequently asked questions

What is TheFaceAnalysis?

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

How do I install TheFaceAnalysis?

It runs as a remote server. In Claude Code: claude mcp add --transport http thefaceanalysis 'https://mcp.thefaceanalysis.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TheFaceAnalysis need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is TheFaceAnalysis open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains TheFaceAnalysis?

It is published by The-Face-Analysis. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.