Interface McpLocalizationRequest

@ThreadSafe public interface McpLocalizationRequest
Immutable, bounded inputs supplied when creating one localization context for an admitted MCP operation.

The effective language ranges initially derive from HTTP Accept-Language. This value intentionally does not define or reserve an MCP localization extension. Separate resources/list and skills/list cursor accessors expose the same opaque application cursor that the corresponding list handler receives, so locale selection can authenticate application-owned pagination state before context creation.

Author:
Mark Allen

  • Method Details

    • getRequestContext

      @NonNull McpRequestContext getRequestContext()
      Returns the admitted semantic MCP request context. Subscription projections supply a derived request without headers, body, trace identifiers or baggage. Its current admitted identity and application context remain available; the authorizer separately receives the original initial request context.
      Returns:
      the admitted semantic MCP request context

    • getLanguageRanges

      @NonNull List<@NonNull Locale.LanguageRange> getLanguageRanges()
      Returns bounded effective client language preferences. The list contains at most 32 ranges after JDK alias expansion, preserves zero-weight exclusions, and is empty for missing, malformed, or over-limit HTTP input. Applications should use this view instead of reparsing the raw header.
      Returns:
      immutable language-range list, possibly empty

    • getContinuationLocale

      @NonNull Optional<@NonNull Locale> getContinuationLocale()
      Returns the verified locale carried by framework-protected continuation state. A present value is a required selection rather than a hint.
      Returns:
      required continuation locale, or empty for an independent request

    • getResourceListCursor

      @NonNull Optional<@NonNull String> getResourceListCursor()
      Returns the opaque application-owned cursor for a custom resources/list operation. A present empty string is preserved. This is empty for every other operation. Soklet does not decode, rewrite, sign, bind, or otherwise interpret the value.
      Returns:
      custom resource-list cursor, or empty

    • getSkillListCursor

      @NonNull Optional<@NonNull String> getSkillListCursor()
      Returns the opaque application-owned cursor for a skills/list operation before localization context creation. A present empty string is preserved as a continuation value. This is empty for every other operation; the resource-list cursor accessor is not reused for Skills pagination.

      The application owns cursor integrity, endpoint/caller and content binding, expiry, and retained snapshot availability across nodes. Soklet does not decode, rewrite, sign, authenticate, or retain the snapshot.

      Returns:
      Skills-list cursor, or empty

    • getFallbackLocale

      @NonNull Locale getFallbackLocale()
      Returns the configured locale of every canonical default text hosted by this server. This default-text fallback is independent of any terminal fallback configured in the provider's localization library.
      Returns:
      configured canonical fallback locale