Interface Icon

Icon definition following the MCP specification.

Supports both URL references and inline base64 data URIs.

See

https://modelcontextprotocol.io/specification/2025-11-25/schema#implementation

Example: URL reference

{ src: "https://example.com/icon.png", mimeType: "image/png", sizes: ["48x48"] }

Example: Base64 data URI

{ src: "data:image/svg+xml;base64,PHN2Zy...", mimeType: "image/svg+xml", sizes: ["any"] }

Example: Theme-specific icon

{ src: "https://example.com/icon-dark.png", theme: "dark" }

interface Icon {
    mimeType?: string;
    sizes?: string[];
    src: string;
    theme?: IconTheme;
}

Index

Properties

mimeType? sizes? src theme?

Properties

`Optional`mimeType

mimeType?: string

MIME type of the icon.

Required MIME types that clients must support:

"image/png"
"image/jpeg"

Optional MIME types:

"image/svg+xml"
"image/webp"

Example

"image/png"

`Optional`sizes

sizes?: string[]

Icon sizes in "WxH" format.

Use ["any"] for scalable formats like SVG.

Example

["48x48", "96x96"]

Example

["any"]

src

src: string

Icon source URI.

Can be:

HTTP/HTTPS URL (e.g., "https://example.com/icon.png")
Data URI with base64 encoding (e.g., "data:image/png;base64,...")

`Optional`theme

theme?: IconTheme

Theme this icon is designed for.

When specified, clients can select the appropriate icon based on their current light/dark mode setting.

Interface Icon

See

Example: URL reference

Example: Base64 data URI

Example: Theme-specific icon

Index

Properties

Properties

`Optional`mimeType

Example

`Optional`sizes

Example

Example

src

`Optional`theme

Settings

On This Page

Interface Icon

See

Example: URL reference

Example: Base64 data URI

Example: Theme-specific icon

Index

Properties

Properties

OptionalmimeType

Example

Optionalsizes

Example

Example

src

Optionaltheme

Settings

On This Page

`Optional`mimeType

`Optional`sizes

`Optional`theme