The Face Analysis — agent plugin
Face shape, facial proportion and face-type answers from
thefaceanalysis.com, for any agent that speaks MCP or
reads Agent Skills. Configuration only: one hosted MCP server and one skill.
| | |
|---|---|
| MCP server | https://mcp.thefaceanalysis.com/mcp (Streamable HTTP, no sign-in, no key) |
| Skill | skills/face-shape-analysis |
| Tools | 7, all read-only |
| Format | Agent Plugins v1 (plugin.json + mcp.json + skills/), plus Claude Code (.claude-plugin/, .mcp.json) |
Install
# Skill only, for Claude Code, Cursor, Codex and 40+ other agents (skills.sh)
npx skills add The-Face-Analysis/thefaceanalysis-agent-plugin
# Hermes Agent (skill + MCP server)
hermes plugins install The-Face-Analysis/thefaceanalysis-agent-plugin
hermes plugins enable thefaceanalysis
# Claude Code, MCP server only
claude mcp add --transport http thefaceanalysis https://mcp.thefaceanalysis.com/mcp
Any other MCP client: add https://mcp.thefaceanalysis.com/mcp as a remote HTTP server.
Tools
| Tool | What it returns |
|---|---|
| classify_face_shape | Face shape from four distances, the rule that matched, the ratios |
| list_face_types | Face, eye, lip and nose types with page URLs |
| get_face_type | One type's definition and exact threshold rule |
| get_reference_statistics | p10–p90 of composite, symmetry, golden ratio, fWHR, midface, PD, canthal tilt |
| get_methodology | Landmark model, thresholds, score construction, change history |
| get_citation | Citation text and license |
| get_embed_snippet | HTML for the free face shape finder widget |
The server does not accept photos. Photo measurement runs in the visitor's browser on
thefaceanalysis.com/face-shape-detector
or in the embeddable widget.
Disclosure
- Hosted-only connector with no local code. Every tool call, with its arguments, goes to
mcp.thefaceanalysis.com. No account, key or personal data is needed or stored. - All tools are read-only. No shell commands, no background processes, no telemetry
from this package. - The tool set is served by the remote server at runtime, so it is not covered by a pinned commit.
Data and license
Package: MIT. Aggregate reference numbers: CC BY 4.0, from 102 adult faces of the Face
Research Lab London Set. They describe that set, not a population.
Source of the server: thefaceanalysis-mcp.
Docs: docs.thefaceanalysis.com.
README from the reviewed commit 207fc77; it updates when the author re-pins.

The Face Analysis