Class McpIcon

java.lang.Object

com.soklet.McpIcon

@ThreadSafe
public final class McpIcon
extends Object

Immutable icon descriptor for an MCP tool, prompt, or resource.

The source must be absolute and contain well-formed UTF-16. Its spelling is retained without URI normalization or a scheme allowlist. MIME types use the same ASCII media-type syntax parser as MCP content. Size hints must use ASCII decimal WxH dimensions with a lowercase x, or exactly any; order, duplicates, and decimal spelling are retained.

Soklet does not fetch icons, verify dimensions or media bytes, establish trusted source domains, or sanitize SVG. Applications and consuming clients own source and rendering policy; prefer trusted HTTPS sources or image data URIs. Construction does not prevalidate the eventual JSON response size.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpIcon.Builder	Mutable builder for an immutable McpIcon.

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull String>	getMimeType()
@NonNull List<@NonNull String>	getSizes()
@NonNull URI	getSource()
@NonNull Optional<@NonNull McpIconTheme>	getTheme()
int	hashCode()
static @NonNull McpIcon.Builder	withSource(@NonNull URI source)	Vends a builder primed with the icon source URI.

Methods inherited from class Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Details

withSource

public static @NonNull McpIcon.Builder withSource(@NonNull URI source)

Vends a builder primed with the icon source URI.

Parameters:

source - absolute icon source URI

Returns:

icon builder

Throws:

IllegalArgumentException - if the source is relative or contains an unpaired surrogate

getSource

public @NonNull URI getSource()

Returns:

icon source URI

getMimeType

public @NonNull Optional<@NonNull String> getMimeType()

Returns:

MIME type, if supplied

getSizes

public @NonNull List<@NonNull String> getSizes()

Returns:

immutable advertised icon sizes

getTheme

public @NonNull Optional<@NonNull McpIconTheme> getTheme()

Returns:

preferred theme, if supplied

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every icon property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural icon hash code