Remote Gravatar MCP Server

A remote Model Context Protocol (MCP) server that provides global access to Gravatar avatars, profiles, and AI-inferred interests.

See Setup for instructions on connecting to this server.

Tools

This server provides 6 comprehensive tools for accessing Gravatar data:

1. get_profile_by_id

• Description: 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

• Description: 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

• Description: 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

• Description: 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

• Description: 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.
  • rating (string, default: undefined): Maximum content rating to display. 'G' (general audiences), 'PG' (parental guidance), 'R' (restricted), 'X' (explicit). If user's avatar exceeds this rating, the default image is shown instead.
• Returns: Avatar image in PNG format

6. get_avatar_by_email

• Description: Retrieve the avatar image 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.
• 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

... View full README on GitHub