# The Face Analysis developer docs

> Documentation for the free, open-source developer tools of The Face Analysis (thefaceanalysis.com): a read-only MCP server with sourced face measurement statistics and a face shape classifier, the dataset as JSON and CSV (CC BY 4.0), and an embeddable face shape widget. Numbers come from 102 faces and describe those faces, not a population.

Hosted MCP server: https://mcp.thefaceanalysis.com/mcp
Source: https://github.com/The-Face-Analysis

## Docs

- [The Face Analysis developer docs](https://docs.thefaceanalysis.com/): Developer documentation for The Face Analysis: an MCP server for AI assistants, a face measurement dataset (JSON and CSV, CC BY 4.0) and an embeddable face shape widget. Free and open source.
- [Quickstart](https://docs.thefaceanalysis.com/quickstart): Add the hosted MCP server to Claude, ChatGPT, Codex or Cursor, ask a question, verify with curl, then use the dataset and the widget. Copy-paste commands.
- [MCP server](https://docs.thefaceanalysis.com/mcp): A free, read-only MCP server with sourced face measurement statistics from 102 faces, face type rules, methodology and a seven-rule face shape classifier. Hosted URL or npx; open source.
- [Connect Claude Code](https://docs.thefaceanalysis.com/mcp/claude-code): How to add The Face Analysis MCP server to Claude Code: Add the hosted URL with one command. A local install works too.
- [Connect Claude (claude.ai and Desktop)](https://docs.thefaceanalysis.com/mcp/claude): How to add The Face Analysis MCP server to Claude (claude.ai and Desktop): A remote server is added as a custom connector. It needs the hosted URL; npx does not work here.
- [Connect Claude Desktop (local)](https://docs.thefaceanalysis.com/mcp/claude-desktop): How to add The Face Analysis MCP server to Claude Desktop (local): To run the server on your own machine with npx, add it to Claude Desktop's config file.
- [Connect ChatGPT](https://docs.thefaceanalysis.com/mcp/chatgpt): How to add The Face Analysis MCP server to ChatGPT: Only a remote (hosted) server works. ChatGPT cannot start a local npx process.
- [Connect Codex](https://docs.thefaceanalysis.com/mcp/codex): How to add The Face Analysis MCP server to Codex: The Codex CLI and the IDE extension read the same config.toml. Use --url for hosted, npx for local.
- [Connect Cursor](https://docs.thefaceanalysis.com/mcp/cursor): How to add The Face Analysis MCP server to Cursor: Add a URL or a command to mcp.json, for one project or for every project.
- [Connect VS Code](https://docs.thefaceanalysis.com/mcp/vscode): How to add The Face Analysis MCP server to VS Code: The workspace file is .vscode/mcp.json. Its top-level key is servers, not mcpServers.
- [Connect Gemini CLI](https://docs.thefaceanalysis.com/mcp/gemini-cli): How to add The Face Analysis MCP server to Gemini CLI: Use gemini mcp add or edit settings.json. The key for a remote server is httpUrl.
- [Connect Any other client](https://docs.thefaceanalysis.com/mcp/other): How to add The Face Analysis MCP server to Any other client: Any MCP client that supports Streamable HTTP works with the hosted URL. Clients that only support stdio use npx.
- [Tool reference](https://docs.thefaceanalysis.com/mcp/tools): Reference for all seven tools of The Face Analysis MCP server: parameters, types, example requests and real responses generated from the published server.
- [Face measurement dataset](https://docs.thefaceanalysis.com/data): Download face measurement statistics from 102 faces as JSON and CSV: fWHR, midface ratio, symmetry, canthal tilt, pupillary distance, type rules and thresholds. Columns, examples in curl, JavaScript, Python and R. CC BY 4.0.
- [Embed the face shape finder](https://docs.thefaceanalysis.com/embed): Add the free face shape finder to a salon, optician, beard or beauty site. Script tag, web component or React; sizes, attributes, resize messages and terms of use.
- [FAQ and troubleshooting](https://docs.thefaceanalysis.com/faq): Answers about The Face Analysis MCP server, dataset and widget: accounts, accuracy, citing, licenses, and fixes when tools do not appear or a connector option is missing.
- [Changelog](https://docs.thefaceanalysis.com/changelog): Dated changes to The Face Analysis developer packages and to the measurement method behind the dataset: thresholds, formulas and reference data.

## Optional

- [Methodology](https://thefaceanalysis.com/methodology): how every number is made and what is not measured.
- [Face measurement statistics](https://thefaceanalysis.com/face-measurement-statistics): the data as a page.
- [Full documentation as one file](https://docs.thefaceanalysis.com/llms-full.txt)