Gravatar MCP Server

MCP Server Gravatar

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

Quick Install

For quick installation in VS Code, click one of the installation buttons below:

%22%2C%22password%22%3Atrue%7D%5D&command=%22npx%22&args=%5B%22-y%22%2C%22%40automattic%2Fmcp-server-gravatar%22%5D&env=%7B%22GRAVATAR_API_KEY%22%3A%22%24%7Binput%3Agravatar_api_key%7D%22%7D) %22%2C%22password%22%3Atrue%7D%5D&command=%22npx%22&args=%5B%22-y%22%2C%22%40automattic%2Fmcp-server-gravatar%22%5D&env=%7B%22GRAVATAR_API_KEY%22%3A%22%24%7Binput%3Agravatar_api_key%7D%22%7D)

Requirements

Node.js

This MCP server requires:

• Node.js: 20.0.0 or higher
• npm: 10.0.0 or higher

The server is tested and supported on:

• Node.js 20 (Active LTS)
• Node.js 22 (Current LTS)
• Node.js 24 (Current)

Installation

You can install and run this server using npx (recommended) or by building from source.

Tools

1. get_profile_by_id

   • Retrieve comprehensive Gravatar profile information using a profile identifier
   • Required inputs:
     • profileIdentifier (string): A Profile Identifier (see Identifier Types section)
   • Returns: Profile object as JSON with comprehensive user information

2. get_profile_by_email

   • Retrieve comprehensive Gravatar profile information using an email address
   • Required inputs:
     • email (string): The email address associated with the Gravatar profile. Can be any valid email format - the system will automatically normalize and hash the email for lookup.
   • Returns: Profile object as JSON with comprehensive user information

3. get_inferred_interests_by_id

   • Fetch AI-inferred interests for a Gravatar profile using a profile identifier
   • Required inputs:
     • profileIdentifier (string): A Profile Identifier (see Identifier Types section)
   • Returns: List of AI-inferred interest names as JSON

4. get_inferred_interests_by_email

   • Fetch AI-inferred interests for a Gravatar profile using an email address
   • Required inputs:
     • email (string): The email address associated with the Gravatar profile. Can be any valid email format - the system will automatically normalize and hash the email for lookup.
   • Returns: List of AI-inferred interest names as JSON

5. get_avatar_by_id

   • Retrieve the avatar image for a Gravatar profile using an avatar identifier
   • Required inputs:
     • avatarIdentifier (string): An Avatar Identifier (see Identifier Types section)
   • Optional inputs:
     • 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 (high-res web), 512 (large displays).
     • defaultOption (string, default: undefined): Fallback image style when no avatar exists. Options: '404' (return HTTP 404 error instead of image), 'mp' (mystery person silhouette), 'identicon' (geometric pattern), 'monsterid' (generated monster), 'wavatar' (generated face), 'retro' (8-bit style), 'robohash' (robot), 'blank' (transparent).
     • forceDefault (boolean, default: undefined): When true, always returns the default image instead of the user's avatar. Useful for testing default options or ensuring consistent placeholder images.
     • `rati