Interface McpRateLimitContext

@ThreadSafe
public interface McpRateLimitContext

Immutable context supplied to an MCP rate limiter.

Implementations may combine the normalized endpoint path, the accepted identity's stable partition key, and the target to select local or distributed rate-limit state. Client-reported identity information is not a trusted partition key.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpAdmissionIdentity	getAdmissionIdentity()	Returns the identity accepted by request admission.
@NonNull McpEndpoint	getEndpoint()	Returns the resolved MCP endpoint.
@NonNull String	getJsonRpcMethod()	Returns the JSON-RPC method.
@NonNull Optional<@NonNull String>	getOperationName()	Returns the resolved operation name, such as a tool name or task ID, when present.
default @NonNull McpOperationType	getOperationType()	Returns the high-level type of the MCP operation being rate-limited.
@NonNull McpProtocolVersion	getProtocolVersion()
@NonNull Request	getRequest()	Returns the original Soklet request.
@NonNull McpRateLimitTarget	getTarget()	Returns the rate-limit stage requesting this acquisition.

Method Details

getRequest

@NonNull Request getRequest()

Returns the original Soklet request.

Returns:

request

getEndpoint

@NonNull McpEndpoint getEndpoint()

Returns the resolved MCP endpoint.

Returns:

endpoint

getProtocolVersion

@NonNull McpProtocolVersion getProtocolVersion()

Returns:

exact validated protocol revision for this acquisition

getAdmissionIdentity

@NonNull McpAdmissionIdentity getAdmissionIdentity()

Returns the identity accepted by request admission.

Returns:

admitted identity

getTarget

@NonNull McpRateLimitTarget getTarget()

Returns the rate-limit stage requesting this acquisition.

Returns:

request or tool target

getJsonRpcMethod

@NonNull String getJsonRpcMethod()

Returns the JSON-RPC method.

Returns:

JSON-RPC method

getOperationType

default @NonNull McpOperationType getOperationType()

Returns the high-level type of the MCP operation being rate-limited.

This classification is suitable for application branching. The exact validated wire value remains available from getJsonRpcMethod().

Returns:

operation type

getOperationName

@NonNull Optional<@NonNull String> getOperationName()

Returns the resolved operation name, such as a tool name or task ID, when present.

On session-enabled 2025 views, a request with malformed operation parameters can reach the request limiter with an empty operation name. Its parameter error is returned after admission, applicable request limiting and session binding. Branch on operation type without requiring this optional value.

Returns:

operation name, or the empty optional