Interface McpResourceListContext

@ThreadSafe public interface McpResourceListContext
Immutable request-specific context for a dynamic resources/list operation.

Soklet preserves a cursor as an opaque, bounded string. The application decides whether it is authentic, unexpired, authorized for the current principal, bound to a retained snapshot and catalog revision, and portable to the instance handling this request.

Author:
Mark Allen

  • Method Details

    • getCursor

      @NonNull Optional<@NonNull String> getCursor()
      Returns the opaque cursor supplied by the client.

      The application owns the cursor's format, integrity, lifetime, authorization binding, and cross-instance portability. A present empty string is preserved as a present protocol value. Invalid, expired, tampered, cross-principal, missing-snapshot, and wrong-revision values should produce the same neutral application error; Soklet does not classify those failures.

      Returns:
      client cursor, or empty when the request omitted cursor

    • getRegisteredResourceDescriptors

      @NonNull List<@NonNull McpResourceDescriptor> getRegisteredResourceDescriptors()
      Returns descriptors derived from this endpoint's exact-URI resource registrations.

      The immutable list is in deterministic registration order and excludes URI-template registrations and resources not enabled for the request's selected protocol revision. It is convenience registration data, not an authorization-filtered result. A custom handler remains the sole authority for the returned page.

      Returns:
      immutable exact-resource descriptors in registration order