# TheFaceAnalysis

> TheFaceAnalysis is an open-source MCP server for analytics and data. Face measurement statistics and a face shape classifier for AI assistants, no photos. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://thefaceanalysis.com/mcp
- **Repository:** https://github.com/the-face-analysis/thefaceanalysis-mcp
- **MCP Registry name:** com.thefaceanalysis/face-analysis
- **Categories:** analytics and data, health and science
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http face-analysis https://mcp.thefaceanalysis.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.thefaceanalysis.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "face-analysis": {
      "url": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "face-analysis": {
      "type": "http",
      "url": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "face-analysis": {
      "serverUrl": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "face-analysis": {
      "type": "http",
      "url": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}
```

## Tools

- `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.

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/thefaceanalysis
