How do I install the gravatar mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GRAVATAR_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Gravatar MCP Server

Gravatar's official MCP Server

Local serverstdioTypeScript

What is the Gravatar MCP Server?

Gravatar's official MCP Server

The short version

Gravatar's official MCP Server, enabling access to avatars, profiles, and inferred interests.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
Returns	Avatar image in PNG format
size	number, default: undefined): Desired avatar size in pixels (1-2048). Images are square, so this sets both width and height. Common sizes: 80 (default web), 200
defaultOption	string, default: undefined): Fallback image style when no avatar exists. Options: '404' (return HTTP 404 error instead of image), 'mp' (mystery person silhouett
forceDefault	boolean, default: undefined): When true, always returns the default image instead of the user's avatar. Useful for testing default options or ensuring consisten
rating	string, default: undefined): Maximum content rating to display. 'G' (general audiences), 'PG' (parental guidance), 'R' (restricted), 'X' (explicit). If user's a
mp	(mystery-person) A simple, cartoon-style silhouetted outline of a person
identicon	A geometric pattern based on an email hash
monsterid	A generated 'monster' with different colors, faces, etc
wavatar	Generated faces with differing features and backgrounds
retro	Awesome generated, 8-bit arcade-style pixelated faces
robohash	A generated robot with different colors, faces, etc
blank	A transparent PNG image
PG	May contain rude gestures, provocatively dressed individuals, the lesser swear words, or mild violence

How to install the Gravatar MCP Server

{
  "mcpServers": {
    "gravatar": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-server-gravatar"
      ],
      "env": {
        "GRAVATAR_API_KEY": "YOUR_GRAVATAR_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
GRAVATAR_API_KEY	Declared in the maintainer’s client configuration.	Optional

Example prompts to try

“Use Gravatar to Returns.”
“Use Gravatar to Installation.”
“Use Gravatar to Testing.”

Frequently asked questions

Gravatar's official MCP Server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.