get_avatar_by_emailRetrieve the avatar image for a Gravatar profile using an email address. The email is automatically normalized and hashed before querying the Gravatar API. <examples>'Get the avatar image for user@example.com' or 'Show me a 200px avatar for john.doe@company.com.'</examples>Input schema{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "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. The email is processed securely and not stored."
},
"size": {
"type": "number",
"description": "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). Gravatar will scale the image appropriately.",
"minimum": 1,
"maximum": 2048
},
"defaultOption": {
"type": "string",
"description": "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). If not specified, Gravatar's default image is returned when no avatar exists.",
"enum": [
"404",
"mp",
"identicon",
"monsterid",
"wavatar",
"retro",
"robohash",
"blank"
]
},
"forceDefault": {
"type": "boolean",
"description": "When true, always returns the default image instead of the user's avatar. Useful for testing default options or ensuring consistent placeholder images."
},
"rating": {
"type": "string",
"description": "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.",
"enum": [
"G",
"PG",
"R",
"X"
]
}
},
"required": [
"email"
]
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
} | — | Read onlyIdempotentOpen world | — |
get_avatar_by_idRetrieve the avatar image for a Gravatar profile using an avatar identifier. More efficient when you already have the hashed identifier. <examples>'Get the avatar image for this Gravatar ID' or 'Show me a 150px avatar for user ID abc123...'</examples>Input schema{
"type": "object",
"properties": {
"avatarIdentifier": {
"type": "string",
"description": "Avatar identifier for the Gravatar profile. An Avatar Identifier is an email address that has been normalized (e.g. lower-cased and trimmed) and then hashed with either SHA256 (preferred) or MD5 (deprecated). Note: Unlike profile identifiers, avatar identifiers cannot use URL slugs - only email hashes are supported."
},
"size": {
"type": "number",
"description": "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). Gravatar will scale the image appropriately.",
"minimum": 1,
"maximum": 2048
},
"defaultOption": {
"type": "string",
"description": "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). If not specified, Gravatar's default image is returned when no avatar exists.",
"enum": [
"404",
"mp",
"identicon",
"monsterid",
"wavatar",
"retro",
"robohash",
"blank"
]
},
"forceDefault": {
"type": "boolean",
"description": "When true, always returns the default image instead of the user's avatar. Useful for testing default options or ensuring consistent placeholder images."
},
"rating": {
"type": "string",
"description": "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.",
"enum": [
"G",
"PG",
"R",
"X"
]
}
},
"required": [
"avatarIdentifier"
]
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
} | — | Read onlyIdempotentOpen world | — |
get_inferred_interests_by_emailRetrieve AI-inferred interests for a Gravatar profile using an email address. Returns experimental machine learning-generated interest data based on public profile information. <hint>When searching for interests, prefer to look up the interests in the Gravatar profile over the inferred interests, since they are specified explicitly by the owner of the Gravatar profile.</hint> <examples>'Get the inferred interests for user@example.com' or 'Show me inferred interests for john.doe@company.com.'</examples>Input schema{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email address for the Gravatar profile. The email will be normalized (lowercased and trimmed) and hashed before querying the Gravatar API."
}
},
"required": [
"email"
]
}Output schema{
"type": "object",
"properties": {
"inferredInterests": {
"type": "array",
"description": "A list of AI-inferred interests",
"items": {
"type": "object",
"description": "An interest the user has added to their profile.",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer",
"description": "The unique identifier for the interest.",
"examples": [
1
]
},
"name": {
"type": "string",
"description": "The name of the interest as originally defined (most often in English).",
"examples": [
"photography"
]
}
}
}
}
},
"required": [
"inferredInterests"
]
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false
} | — | Read onlyNon-idempotentOpen world | — |
get_inferred_interests_by_idRetrieve AI-inferred interests for a Gravatar profile using a profile identifier. Returns experimental machine learning-generated interest data based on public profile information. <hint>When searching for interests, prefer to look up the interests in the Gravatar profile over the inferred interests, since they are specified explicitly by the owner of the Gravatar profile.</hint> <examples>'Get the inferred interests for user ID abc123...' or 'Show me inferred interests for username johndoe.'</examples>Input schema{
"type": "object",
"properties": {
"profileIdentifier": {
"type": "string",
"description": "Profile identifier for the Gravatar profile. A Profile Identifier is either an email address that has been normalized (e.g. lower-cased and trimmed) and then hashed with either SHA256 (preferred) or MD5 (deprecated), or Gravatar profile URL slug (e.g., 'username' from gravatar.com/username)."
}
},
"required": [
"profileIdentifier"
]
}Output schema{
"type": "object",
"properties": {
"inferredInterests": {
"type": "array",
"description": "A list of AI-inferred interests",
"items": {
"type": "object",
"description": "An interest the user has added to their profile.",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer",
"description": "The unique identifier for the interest.",
"examples": [
1
]
},
"name": {
"type": "string",
"description": "The name of the interest as originally defined (most often in English).",
"examples": [
"photography"
]
}
}
}
}
},
"required": [
"inferredInterests"
]
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false
} | — | Read onlyNon-idempotentOpen world | — |
get_profile_by_emailRetrieve comprehensive Gravatar profile information using an email address. Returns detailed profile data including personal information, social accounts, and avatar details. <examples>'Show me the Gravatar profile for john.doe@example.com' or 'Get profile info for user@company.com.'</examples>Input schema{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "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. The email is processed securely and not stored."
}
},
"required": [
"email"
]
}Output schema{
"type": "object",
"description": "A user's profile information.",
"required": [
"hash",
"display_name",
"profile_url",
"avatar_url",
"avatar_alt_text",
"location",
"description",
"job_title",
"company",
"verified_accounts",
"pronunciation",
"pronouns"
],
"properties": {
"hash": {
"type": "string",
"description": "The SHA256 hash of the user's primary email address.",
"examples": [
"31c5543c1734d25c7206f5fd591525d0295bec6fe84ff82f946a34fe970a1e66"
]
},
"display_name": {
"type": "string",
"description": "The user's display name. This is the name that is displayed on their profile.",
"examples": [
"Alex Morgan"
]
},
"profile_url": {
"type": "string",
"description": "The full URL for the user's profile.",
"format": "uri",
"examples": [
"https://gravatar.com/example"
]
},
"avatar_url": {
"type": "string",
"format": "uri",
"description": "The URL for the user's avatar image if it has been set.",
"examples": [
"https://0.gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5"
]
},
"avatar_alt_text": {
"type": "string",
"description": "The alt text for the user's avatar image if it has been set.",
"examples": [
"Alex Morgan's avatar image. Alex is smiling and standing in beside a large dog who is looking up at Alex."
]
},
"location": {
"type": "string",
"description": "The user's location.",
"examples": [
"New York, USA"
]
},
"description": {
"type": "string",
"description": "The about section on a user's profile.",
"examples": [
"I like playing hide and seek."
]
},
"job_title": {
"type": "string",
"description": "The user's job title.",
"examples": [
"Landscape Architect"
]
},
"company": {
"type": "string",
"description": "The user's current company's name.",
"examples": [
"ACME Corp"
]
},
"verified_accounts": {
"type": "array",
"description": "A list of verified accounts the user has added to their profile. This is limited to a max of 4 in unauthenticated requests.",
"items": {
"$ref": "#/components/schemas/VerifiedAccount"
}
},
"pronunciation": {
"type": "string",
"description": "The phonetic pronunciation of the user's name.",
"examples": [
"Al-ex Mor-gan"
]
},
"pronouns": {
"type": "string",
"description": "The pronouns the user uses.",
"examples": [
"She/They"
]
},
"timezone": {
"type": "string",
"description": "The timezone the user has. This is only provided in authenticated API requests.",
"examples": [
"Europe/Bratislava"
]
},
"languages": {
"type": "array",
"description": "The languages the user knows. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Language"
}
},
"first_name": {
"type": "string",
"description": "User's first name. This is only provided in authenticated API requests.",
"examples": [
"Alex"
]
},
"last_name": {
"type": "string",
"description": "User's last name. This is only provided in authenticated API requests.",
"examples": [
"Morgan"
]
},
"is_organization": {
"type": "boolean",
"description": "Whether user is an organization. This is only provided in authenticated API requests.",
"examples": [
false
]
},
"header_image": {
"type": "string",
"description": "The header image used in the main profile card.",
"examples": [
"url('https://gravatar.com/userimage/209234789/cdebd0ed415kfa2g562ba5c34b1570c2') no-repeat 50% 1% / 100%"
]
},
"background_color": {
"type": "string",
"description": "The profile background color.",
"examples": [
"rgb(33, 0, 166)",
"linear-gradient(135deg, rgb(2, 3, 129) 0%, rgb(40, 116, 252) 100%)"
]
},
"links": {
"type": "array",
"description": "A list of links the user has added to their profile. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"interests": {
"type": "array",
"description": "A list of interests the user has added to their profile. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Interest"
}
},
"payments": {
"type": "object",
"required": [
"links",
"crypto_wallets"
],
"description": "The user's public payment information. This is only provided in authenticated API requests.",
"properties": {
"links": {
"type": "array",
"description": "A list of payment URLs the user has added to their profile.",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"crypto_wallets": {
"type": "array",
"description": "A list of crypto currencies the user accepts.",
"items": {
"$ref": "#/components/schemas/CryptoWalletAddress"
}
}
}
},
"contact_info": {
"type": "object",
"description": "The user's contact information. This is only available if the user has chosen to make it public. This is only provided in authenticated API requests.",
"properties": {
"home_phone": {
"type": "string",
"description": "The user's home phone number.",
"examples": [
"+1-555-555-0100"
]
},
"work_phone": {
"type": "string",
"description": "The user's work phone number.",
"examples": [
"+1-555-555-0101"
]
},
"cell_phone": {
"type": "string",
"description": "The user's cell phone number.",
"examples": [
"+1-555-555-0102"
]
},
"email": {
"type": "string",
"description": "The user's email address as provided on the contact section of the profile. Might differ from their account emails.",
"format": "email",
"examples": [
"alex@example.com"
]
},
"contact_form": {
"type": "string",
"description": "The URL to the user's contact form.",
"format": "uri",
"examples": [
"https://example.com/contact-me"
]
},
"calendar": {
"type": "string",
"description": "The URL to the user's calendar.",
"format": "uri",
"examples": [
"https://example.com/calendar"
]
}
}
},
"gallery": {
"type": "array",
"description": "Additional images a user has uploaded. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/GalleryImage"
}
},
"number_verified_accounts": {
"type": "integer",
"description": "The number of verified accounts the user has added to their profile. This count includes verified accounts the user is hiding from their profile. This is only provided in authenticated API requests.",
"examples": [
3
]
},
"last_profile_edit": {
"type": [
"string",
"null"
],
"nullable": true,
"description": "The date and time (UTC) the user last edited their profile. This is only provided in authenticated API requests.",
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"examples": [
"2021-10-01T12:00:00Z"
]
},
"registration_date": {
"type": [
"string",
"null"
],
"nullable": true,
"description": "The date the user registered their account. This is only provided in authenticated API requests.",
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"examples": [
"2021-10-01T12:00:00Z"
]
}
}
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
} | — | Read onlyIdempotentOpen world | — |
get_profile_by_idRetrieve comprehensive Gravatar profile information using a profile identifier. Returns detailed profile data including personal information, social accounts, and avatar details. <examples>'Get the profile for Gravatar user with ID abc123...' or 'Show me the profile for username johndoe.'</examples>Input schema{
"type": "object",
"properties": {
"profileIdentifier": {
"type": "string",
"description": "Profile identifier for the Gravatar profile. A Profile Identifier is either an email address that has been normalized (e.g. lower-cased and trimmed) and then hashed with either SHA256 (preferred) or MD5 (deprecated), or Gravatar profile URL slug (e.g., 'username' from gravatar.com/username)."
}
},
"required": [
"profileIdentifier"
]
}Output schema{
"type": "object",
"description": "A user's profile information.",
"required": [
"hash",
"display_name",
"profile_url",
"avatar_url",
"avatar_alt_text",
"location",
"description",
"job_title",
"company",
"verified_accounts",
"pronunciation",
"pronouns"
],
"properties": {
"hash": {
"type": "string",
"description": "The SHA256 hash of the user's primary email address.",
"examples": [
"31c5543c1734d25c7206f5fd591525d0295bec6fe84ff82f946a34fe970a1e66"
]
},
"display_name": {
"type": "string",
"description": "The user's display name. This is the name that is displayed on their profile.",
"examples": [
"Alex Morgan"
]
},
"profile_url": {
"type": "string",
"description": "The full URL for the user's profile.",
"format": "uri",
"examples": [
"https://gravatar.com/example"
]
},
"avatar_url": {
"type": "string",
"format": "uri",
"description": "The URL for the user's avatar image if it has been set.",
"examples": [
"https://0.gravatar.com/avatar/33252cd1f33526af53580fcb1736172f06e6716f32afdd1be19ec3096d15dea5"
]
},
"avatar_alt_text": {
"type": "string",
"description": "The alt text for the user's avatar image if it has been set.",
"examples": [
"Alex Morgan's avatar image. Alex is smiling and standing in beside a large dog who is looking up at Alex."
]
},
"location": {
"type": "string",
"description": "The user's location.",
"examples": [
"New York, USA"
]
},
"description": {
"type": "string",
"description": "The about section on a user's profile.",
"examples": [
"I like playing hide and seek."
]
},
"job_title": {
"type": "string",
"description": "The user's job title.",
"examples": [
"Landscape Architect"
]
},
"company": {
"type": "string",
"description": "The user's current company's name.",
"examples": [
"ACME Corp"
]
},
"verified_accounts": {
"type": "array",
"description": "A list of verified accounts the user has added to their profile. This is limited to a max of 4 in unauthenticated requests.",
"items": {
"$ref": "#/components/schemas/VerifiedAccount"
}
},
"pronunciation": {
"type": "string",
"description": "The phonetic pronunciation of the user's name.",
"examples": [
"Al-ex Mor-gan"
]
},
"pronouns": {
"type": "string",
"description": "The pronouns the user uses.",
"examples": [
"She/They"
]
},
"timezone": {
"type": "string",
"description": "The timezone the user has. This is only provided in authenticated API requests.",
"examples": [
"Europe/Bratislava"
]
},
"languages": {
"type": "array",
"description": "The languages the user knows. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Language"
}
},
"first_name": {
"type": "string",
"description": "User's first name. This is only provided in authenticated API requests.",
"examples": [
"Alex"
]
},
"last_name": {
"type": "string",
"description": "User's last name. This is only provided in authenticated API requests.",
"examples": [
"Morgan"
]
},
"is_organization": {
"type": "boolean",
"description": "Whether user is an organization. This is only provided in authenticated API requests.",
"examples": [
false
]
},
"header_image": {
"type": "string",
"description": "The header image used in the main profile card.",
"examples": [
"url('https://gravatar.com/userimage/209234789/cdebd0ed415kfa2g562ba5c34b1570c2') no-repeat 50% 1% / 100%"
]
},
"background_color": {
"type": "string",
"description": "The profile background color.",
"examples": [
"rgb(33, 0, 166)",
"linear-gradient(135deg, rgb(2, 3, 129) 0%, rgb(40, 116, 252) 100%)"
]
},
"links": {
"type": "array",
"description": "A list of links the user has added to their profile. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"interests": {
"type": "array",
"description": "A list of interests the user has added to their profile. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/Interest"
}
},
"payments": {
"type": "object",
"required": [
"links",
"crypto_wallets"
],
"description": "The user's public payment information. This is only provided in authenticated API requests.",
"properties": {
"links": {
"type": "array",
"description": "A list of payment URLs the user has added to their profile.",
"items": {
"$ref": "#/components/schemas/Link"
}
},
"crypto_wallets": {
"type": "array",
"description": "A list of crypto currencies the user accepts.",
"items": {
"$ref": "#/components/schemas/CryptoWalletAddress"
}
}
}
},
"contact_info": {
"type": "object",
"description": "The user's contact information. This is only available if the user has chosen to make it public. This is only provided in authenticated API requests.",
"properties": {
"home_phone": {
"type": "string",
"description": "The user's home phone number.",
"examples": [
"+1-555-555-0100"
]
},
"work_phone": {
"type": "string",
"description": "The user's work phone number.",
"examples": [
"+1-555-555-0101"
]
},
"cell_phone": {
"type": "string",
"description": "The user's cell phone number.",
"examples": [
"+1-555-555-0102"
]
},
"email": {
"type": "string",
"description": "The user's email address as provided on the contact section of the profile. Might differ from their account emails.",
"format": "email",
"examples": [
"alex@example.com"
]
},
"contact_form": {
"type": "string",
"description": "The URL to the user's contact form.",
"format": "uri",
"examples": [
"https://example.com/contact-me"
]
},
"calendar": {
"type": "string",
"description": "The URL to the user's calendar.",
"format": "uri",
"examples": [
"https://example.com/calendar"
]
}
}
},
"gallery": {
"type": "array",
"description": "Additional images a user has uploaded. This is only provided in authenticated API requests.",
"items": {
"$ref": "#/components/schemas/GalleryImage"
}
},
"number_verified_accounts": {
"type": "integer",
"description": "The number of verified accounts the user has added to their profile. This count includes verified accounts the user is hiding from their profile. This is only provided in authenticated API requests.",
"examples": [
3
]
},
"last_profile_edit": {
"type": [
"string",
"null"
],
"nullable": true,
"description": "The date and time (UTC) the user last edited their profile. This is only provided in authenticated API requests.",
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"examples": [
"2021-10-01T12:00:00Z"
]
},
"registration_date": {
"type": [
"string",
"null"
],
"nullable": true,
"description": "The date the user registered their account. This is only provided in authenticated API requests.",
"format": "date-time",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"examples": [
"2021-10-01T12:00:00Z"
]
}
}
}Annotations{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
} | — | Read onlyIdempotentOpen world | — |