Class McpResourceLink

java.lang.Object

com.soklet.McpResourceLink

All Implemented Interfaces:

McpContentBlock

@ThreadSafe
public final class McpResourceLink
extends Object
implements McpContentBlock

Immutable MCP content block linking to a resource.

When returned as tool content, optional icons are omitted from the 2025-06-18 wire projection and retained for 2025-11-25 and the modern revision. Projection does not mutate this value.

Author:

Mark Allen

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
static @NonNull McpResourceLink	fromResourceDescriptor(@NonNull McpResourceDescriptor resourceDescriptor)	Creates a resource-link content block from an existing concrete resource descriptor.
@NonNull Optional<@NonNull McpContentAnnotations>	getAnnotations()	Returns optional presentation annotations for this content block.
@NonNull Optional<@NonNull String>	getDescription()
@NonNull List<@NonNull McpIcon>	getIcons()
@NonNull McpJsonObject	getMetadata()	Returns protocol extension metadata associated with this content block.
@NonNull Optional<@NonNull String>	getMimeType()
@NonNull String	getName()
@NonNull Optional<@NonNull Long>	getSizeInBytes()
@NonNull Optional<@NonNull String>	getTitle()
@NonNull URI	getUri()
int	hashCode()
static @NonNull McpResourceLink.Builder	withUriAndName(@NonNull URI uri, @NonNull String name)	Vends a builder primed with the linked resource URI and name.

Methods inherited from class Object

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

Method Details

withUriAndName

public static @NonNull McpResourceLink.Builder withUriAndName(@NonNull URI uri,
 @NonNull String name)

Vends a builder primed with the linked resource URI and name.

Parameters:

uri - absolute normalized resource URI in ASCII wire form

name - resource name

Returns:

resource-link builder

Throws:

IllegalArgumentException - if the URI is relative, not normalized, not in ASCII wire form, or the name is blank

fromResourceDescriptor

public static @NonNull McpResourceLink fromResourceDescriptor(@NonNull McpResourceDescriptor resourceDescriptor)

Creates a resource-link content block from an existing concrete resource descriptor. Every descriptor property is preserved.

Parameters:

resourceDescriptor - resource descriptor to copy

Returns:

immutable resource link

Throws:

NullPointerException - if resourceDescriptor is null

getUri

public @NonNull URI getUri()

Returns:

absolute normalized linked-resource URI in ASCII wire form

getName

public @NonNull String getName()

Returns:

linked resource name

getTitle

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

Returns:

human-readable title, if supplied

getDescription

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

Returns:

human-readable description, if supplied

getMimeType

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

Returns:

resource MIME type, if supplied

getIcons

public @NonNull List<@NonNull McpIcon> getIcons()

Returns:

immutable icon list in registration order

getAnnotations

public @NonNull Optional<@NonNull McpContentAnnotations> getAnnotations()

Description copied from interface: McpContentBlock

Returns optional presentation annotations for this content block.

Specified by:

getAnnotations in interface McpContentBlock

Returns:

content annotations, if supplied

getSizeInBytes

public @NonNull Optional<@NonNull Long> getSizeInBytes()

Returns:

resource size in bytes, if supplied

getMetadata

public @NonNull McpJsonObject getMetadata()

Description copied from interface: McpContentBlock

Returns protocol extension metadata associated with this content block.

Specified by:

getMetadata in interface McpContentBlock

Returns:

immutable extension metadata

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every linked-resource property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural linked-resource hash code