Skip to content
MCP server

TheFaceAnalysis

Face measurement statistics and a face shape classifier for AI assistants, no photos

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.thefaceanalysis.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "face-analysis": {
      "url": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data