home / mcp / gravatar mcp server

Gravatar MCP Server

Provides access to Gravatar avatars, profiles, and AI-inferred interests via MCP endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can run the Gravatar MCP Server to access avatars, profiles, and AI-inferred interests for Gravatar users. This server exposes practical endpoints you can call from your MCP client to retrieve profiles, avatars, and inferred data, all backed by Gravatar data with optional API key support for higher rate limits.

How to use

Use an MCP client to connect to the Gravatar MCP Server and call its available tools. You can fetch a user profile by a profile identifier or by an email, and you can obtain AI-inferred interests for a profile. You can also retrieve the avatar image for a profile by identifier or by email. If you provide an API key, you gain higher rate limits and access to additional features.

How to install

Prerequisites you need before starting:

Node.js 20.0.0 or higher
npm 10.0.0 or higher

Run a quick setup using the MCP workflow in your environment to start the server directly with MCP tooling.

Option A — Quick start with no local build (recommended for testing):

npx -y @automattic/mcp-server-gravatar

Option B — Start with an API key to increase rate limits (set the key in your environment before starting):

export GRAVATAR_API_KEY=your-api-key-here
npx -y @automattic/mcp-server-gravatar

Option C — Start without an API key (suboptimal for rate limits):

npx -y @automattic/mcp-server-gravatar

Available tools

get_profile_by_id

Retrieve comprehensive Gravatar profile information using a profile identifier. Requires a profileIdentifier input and returns the full profile object as JSON.

get_profile_by_email

Retrieve comprehensive Gravatar profile information using an email address. Provides a normalized and hashed lookup and returns the profile object as JSON.

get_inferred_interests_by_id

Fetch AI-inferred interests for a Gravatar profile using a profile identifier. Returns a JSON list of interest names.

get_inferred_interests_by_email

Fetch AI-inferred interests for a Gravatar profile using an email address. Returns a JSON list of interest names.

get_avatar_by_id

Retrieve the avatar image for a Gravatar profile using an avatar identifier. Supports optional size, defaultOption, forceDefault, and rating parameters and returns a PNG image.

get_avatar_by_email

Retrieve the avatar image for a Gravatar profile using an email address. Supports optional size, defaultOption, forceDefault, and rating parameters and returns a PNG image.