MCP server

TheFaceAnalysis Official

com.thefaceanalysis/face-analysis

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

thefaceanalysis.com (verified by the MCP Registry)

Status

Working at last check

Tools

7

Token cost

About 1,198 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.face-analysis]
url = "https://mcp.thefaceanalysis.com/mcp"

Gemini CLI

{"mcpServers":{"face-analysis":{"httpUrl":"https://mcp.thefaceanalysis.com/mcp"}}}

Cursor

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

VS Code

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

Antigravity

agy mcp add face-analysis https://mcp.thefaceanalysis.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"face-analysis","server_url":"https://mcp.thefaceanalysis.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"face-analysis","server_url":"https://mcp.thefaceanalysis.com/mcp"}

Tools

• classify_face_shape ~319 tokens
  Runs the same seven-rule face shape classifier as thefaceanalysis.com/face-shape-detector on four distances (any consistent unit: pixels, mm or landmark units). Returns the shape, the rule that matched and the four ratios. It does not look at photos: to measure a photo, use the widget (get_embed_sni
• get_citation ~73 tokens
  Citation text, license (CC BY 4.0 for the aggregate numbers) and the source photo set. Use when quoting a number.
• get_embed_snippet ~136 tokens
  HTML a website owner can paste to add the free face shape finder (it measures the visitor's photo in their browser, no sign-up). Includes the visible credit link the terms ask for.
• get_face_type ~139 tokens
  Definition and how the type is measured from a front photo (the exact threshold rule), plus its page URL. Example: category 'face', slug 'oval'.
• get_methodology ~143 tokens
  How the numbers are made: the landmark model, every classification threshold, how the 1-10 score is built, and how it correlated with 2,513 human raters on the same faces (it did not predict them). Includes the method change history.
• get_reference_statistics ~244 tokens
  Percentiles (p10, p25, median, p75, p90, min, max) of facial measurements from 102 adult faces (49 women, 53 men) of the Face Research Lab London Set, measured with a 478-point MediaPipe landmarker. Measures: composite score, symmetry, golden ratio fit, fWHR, midface ratio, pupillary distance, canth
• list_face_types ~144 tokens
  Lists the types the site's detectors use, with slug, name, page URL and how many of the 102 reference faces each type covered. The split shows how the detector divides these faces, not how common a type is in a population.

Related MCP servers

• iLook Face Analysis
  Analyze user-submitted face photos with a complete report or 13 focused face-analysis tools.
• FaceRuler
  PSL score tiers, face shape classification and looksmaxxing term lookup from FaceRuler.
• Mart402 Extract
  Web extraction, OCR (Japanese-strong), invoice and company data for AI agents. x402, no API key.
• Open Archives
  MCP server for Open Archives: Dutch genealogical records and historical page transcriptions.
• BlockWerk
  Build, run and analyse block-diagram simulations: PID, Bode, FFT, optimisation and code export.
• esimgomobile — Travel eSIM Tools
  Travel eSIM plan catalog, coverage and trip-planning tools for agents and developers.
• Voidly Hosted MCP
  Voidly MCP: research, Atlas score, capabilities; gated Voidpay, Voidmail, Home, board and bounty.
• Oshyn Free AI-Powered Website Tools
  Free AI-powered DXP tools by Oshyn: GEO & Reliability scan, Choose New DXP and Estimate DXP Budget.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.thefaceanalysis/face-analysis.svg)](https://aptlynx.net/servers/com.thefaceanalysis/face-analysis)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents