Skip to main content
MCP server CX Codex

TheFaceAnalysis — Claude Code MCP server: what it does and setup

TheFaceAnalysis supplies AI assistants with face shape classification rules and measurement percentiles across 102 faces without handling images.

MIT updated 2026-10-26

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http face-analysis https://mcp.thefaceanalysis.com/mcp
Open on GitHub

What TheFaceAnalysis does

This server runs strictly in read-only mode and refuses image uploads. Instead of parsing photos, classify_face_shape accepts four pre-measured distances and applies seven sequential rules to identify the geometry. Handlers like list_face_types and get_face_type return explicit threshold values for lips, noses, eyes, and jawlines.

Through get_reference_statistics, your model reads distributions for midface ratios, fWHR, symmetry, and canthal tilt. These metrics come from 102 subjects in the Face Research Lab London Set. It also provides citation metadata under CC BY 4.0 alongside methodology verified against 2,513 human evaluators.

The server contains zero computer vision routines. You must extract coordinate distances elsewhere before querying these tools.

What it helps with

  • Classify face geometry from four measured distances
  • Retrieve percentile benchmarks for facial symmetry and fWHR
  • Inspect numeric threshold rules for nose and eye categories
  • Generate an embeddable widget snippet for web pages

Example prompts for the agent

  • Classify face shape using distances 140, 116, 124, and 185 with TheFaceAnalysis
  • Show fWHR percentiles for male faces in the reference dataset
  • Get the exact threshold rules used to categorize eye shapes

How to install TheFaceAnalysis

Platform CLI: remote server

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about TheFaceAnalysis

How to install TheFaceAnalysis in Claude Code?

Run claude mcp add --transport http thefaceanalysis https://mcp.thefaceanalysis.com/mcp in your CLI.

Can TheFaceAnalysis process uploaded pictures?

No, it is read-only and accepts numbers rather than photos. You supply extracted face distances directly to the classifier tool.

Can I run TheFaceAnalysis locally instead of using the remote endpoint?

Yes, configure your MCP client with the local command npx and arguments ["-y", "thefaceanalysis-mcp"].

Similar MCP servers

All MCP servers for AI and ML →

Project sponsors

Companies that keep this analytics open