Face Transform MCP server
{
"mcpServers": {
"acedatacloud-face-transform": {
"command": "uvx",
"args": [
"mcp-face-transform"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<acedatacloud_api_token>"
}
}
}
}{
"mcpServers": {
"acedatacloud-face-transform": {
"command": "uvx",
"args": [
"mcp-face-transform"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<acedatacloud_api_token>"
}
}
}
}{
"mcpServers": {
"acedatacloud-face-transform": {
"command": "uvx",
"args": [
"mcp-face-transform"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<acedatacloud_api_token>"
}
}
}
}{
"servers": {
"acedatacloud-face-transform": {
"command": "uvx",
"args": [
"mcp-face-transform"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "${input:acedatacloud_api_token}"
}
}
},
"inputs": [
{
"id": "acedatacloud_api_token",
"type": "promptString",
"description": "Acedatacloud api token",
"password": true
}
]
}{
"mcpServers": {
"acedatacloud-face-transform": {
"command": "uvx",
"args": [
"mcp-face-transform"
],
"env": {
"ACEDATACLOUD_API_TOKEN": "<acedatacloud_api_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall uvx mcp-face-transformversion 2026.8.23.0
What it does
An MCP server that exposes the AceDataCloud Face Transform API for facial analysis and manipulation. It provides tools for detecting facial keypoints, beautifying faces, transforming age and gender, swapping faces, cartoonizing portraits, and detecting liveness. Useful for developers building applications that need to analyze or modify facial features in images.
- Detect and extract 90+ facial landmarks from multiple faces in an image for facial analysis or alignment tasks.
- Apply beautification effects like smoothing, whitening, and eye enlarging to portraits.
- Verify whether a face in an image is from a live capture or a printed/screen photo using liveness detection.
Tools this server exposes
| Tool | Does |
|---|---|
| face_detect_keypoints | Detect 90+ keypoints per face in an image with multi-face support. |
| face_beautify | Apply smoothing, whitening, face slimming, and eye enlarging effects to a portrait. |
| face_change_age | Age or de-age a portrait. |
| face_change_gender | Swap perceived facial gender characteristics in a portrait. |
| face_swap | Move a source face onto a target image with optional async webhook support. |
| face_cartoonize | Render a portrait in cartoon or animated style. |
| face_detect_liveness | Distinguish a live capture from a printed or screen photo. |
| face_get_usage_guide | Get a concise reference guide for client-side tool usage. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.