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
claude mcp add --transport http face-analysis https://mcp.thefaceanalysis.com/mcpWhat 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/mcpPlatform CLI: remote server
codex mcp add thefaceanalysis --url https://mcp.thefaceanalysis.com/mcpConfig file
{
"mcpServers": {
"thefaceanalysis": {
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Config file
{
"servers": {
"thefaceanalysis": {
"type": "http",
"url": "https://mcp.thefaceanalysis.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http thefaceanalysis https://mcp.thefaceanalysis.com/mcpStep 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"].