TheFaceAnalysis
Face measurement statistics and a face shape classifier for AI assistants, no photos
- Pricing
- Open source
- Platforms
- API, CLI, self-hosted
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 2 days ago
About TheFaceAnalysis
TheFaceAnalysis is an open-source MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.
This server is a reference library, not a photo analyser. It holds measurement statistics from 102 faces taken from one research set photographed in London, and it returns the exact threshold rules the site uses to label face, eye, lip and nose types. Percentiles cover ratios such as fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance and canthal tilt, split by all, women and men.
An assistant can also classify a face shape if you give it four distances; it applies the site's seven rules in the site's order. A methodology tool explains thresholds, how the score is built and how it compared against 2,513 raters, and a citation tool returns the CC BY 4.0 licence and downloads. A further tool produces an embed snippet for the site's face shape widget.
The README is explicit about limits. The numbers describe these 102 faces rather than a population, type splits show how the detector divides them rather than how common a type is, and no accuracy figure is claimed. Photo measurement is done separately in the browser on the website.
Install
Run in a terminal
claude mcp add --transport http face-analysis https://mcp.thefaceanalysis.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.thefaceanalysis.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"face-analysis": {
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"face-analysis": {
"type": "http",
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"face-analysis": {
"serverUrl": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"face-analysis": {
"type": "http",
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- get_reference_statistics
- Percentiles of fWHR, midface ratio, symmetry, golden ratio fit, pupillary distance and canthal tilt on 102 faces.
- list_face_types
- Lists face, eye, lip and nose types.
- get_face_type
- A type's definition and exact threshold rule.
- classify_face_shape
- Face shape from four distances using the site's seven rules.
- get_methodology
- Thresholds, score construction, validity and change history.
- get_citation
- Citation text, CC BY 4.0 licence, source photo set and downloads.
- get_embed_snippet
- HTML for the free face shape widget.
What it does
- Reference statistics
- Percentiles of facial ratios across 102 faces.
- Type definitions
- Face, eye, lip and nose types with exact threshold rules.
- Face shape classifier
- Classifies from four distances using seven ordered rules.
- Methodology
- Thresholds, score construction and validity against 2,513 raters.
- Citation data
- Licence, source photo set and downloads.
- Widget embed
- HTML snippet for the face shape widget.
Good for
- Cite measurement statistics in an article on facial ratios
- Look up the exact rule behind a face shape label
- Classify a face shape from four measured distances
- Check the median fWHR of the reference set
- Embed a face shape widget on a page
Pricing
Open source
Free and open source; data CC BY 4.0, code MIT
Prices change. Check thefaceanalysis.com before you buy.
TheFaceAnalysis FAQ
Does it analyse my photo?
No. It is read-only and takes no photo; photo measurement runs separately in the browser on the website.
Is it free?
Yes. The site calls the server free, open source and account-free.
What is the median fWHR?
The site's check prompt gives 1.78 across the 102 reference faces.
How accurate is the classifier?
No accuracy figure is claimed for any type label.
What licences apply?
Data is CC BY 4.0 and the code is MIT.
Is TheFaceAnalysis free?
Yes. TheFaceAnalysis is open source, so you can use and self-host it for free.
How do I add TheFaceAnalysis to Claude Code?
Run this command in your terminal: claude mcp add --transport http face-analysis https://mcp.thefaceanalysis.com/mcp
What are the best alternatives to TheFaceAnalysis?
The closest alternatives to TheFaceAnalysis are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tooluniverse, Oya Browser and Tapetide - Indian Stock Market MCP.
Alternatives to TheFaceAnalysis

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data