get_profile_by_idLABSCO SUMMARY
The public profile behind an address, resolved.
Gravatar is the identity layer a great many sites already use. This makes it queryable, so an assistant can put a name and a face to an email address without scraping anything.
What it is
Gravatar's official MCP server, from Automattic. It answers by email address or by profile identifier and returns what Gravatar publishes for that account.
What you get
- A public Gravatar profile looked up from an email address
- The same profile looked up from a Gravatar profile identifier
- The avatar image for an identifier
- Gravatar's inferred interests for an account, by email or by identifier
Requirements
Node.js 20.0.0 or higher and npm 10.0.0 or higher; it is tested across current Node releases. It runs straight from npx, and a GRAVATAR_API_KEY is optional — the server works without one.
Setup effort
One command — npx -y @automattic/mcp-server-gravatar
USE CASES
01
Putting a face to an address in your data
Hand it the email and the public profile comes back, avatar included.
02
Enriching a signup list
Resolve addresses to whatever Gravatar publishes, and skip the ones with nothing behind them.
03
Working from an identifier rather than an address
Look up by profile identifier for the cases where the email is not yours to hold.
04
Reading what Gravatar infers about an account
Inferred interests come back for an email or an identifier — Gravatar's own reading of the account, clearly labelled as such.
6 tools
Listed in project docs. Your client may show a different list.
get_profile_by_emailget_inferred_interests_by_idget_inferred_interests_by_emailget_avatar_by_idget_avatar_by_emailBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 20.0.0 or later
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @automattic/mcp-server-gravatarMCP Clients
VS Code — API key
VS CODE — API KEY · JSON
{
"inputs": [
{
"type": "promptString",
"id": "gravatar_api_key",
"description": "Gravatar API Key (optional)",
"password": true
}
],
"servers": {
"gravatar": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-server-gravatar"
],
"env": {
"GRAVATAR_API_KEY": "${input:gravatar_api_key}"
}
}
}
}VS Code — No API key
VS CODE — NO API KEY · JSON
{
"servers": {
"gravatar": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-server-gravatar"
]
}
}
}Claude Desktop — API key
CLAUDE DESKTOP — API KEY · JSON
{
"mcpServers": {
"gravatar": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-server-gravatar"
],
"env": {
"GRAVATAR_API_KEY": "<YOUR_GRAVATAR_API_KEY>"
}
}
}
}Claude Desktop — No API key
CLAUDE DESKTOP — NO API KEY · JSON
{
"mcpServers": {
"gravatar": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-server-gravatar"
]
}
}
}Any MCP client — Local build
ANY MCP CLIENT — LOCAL BUILD · TERMINAL
git clone https://github.com/Automattic/mcp-server-gravatar.git
cd mcp-server-gravatar
npm installThen update your MCP client configuration:
ANY MCP CLIENT — LOCAL BUILD · JSON
{
"mcpServers": {
"gravatar": {
"command": "npx",
"args": [
"<YOUR_PATH_TO_MCP_SERVER_GRAVATAR>"
],
"env": {
"GRAVATAR_API_KEY": "<YOUR_GRAVATAR_API_KEY>"
}
}
}
}<YOUR_PATH_TO_MCP_SERVER_GRAVATAR> is the absolute path of your clone. GRAVATAR_API_KEY is optional — leave out the env block to run without one.
