> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Middleware
> Middleware API Documentation
export const RandomGradientBackground = ({className, color, children, grayscaled = false}) => {
const saturation = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[1] || "0");
}
return grayscaled ? 0 : 0.2;
}, [color, grayscaled]);
const lightness = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[0] || "0.5");
}
return grayscaled ? 0.3 : 0.4;
}, [color, grayscaled]);
const randomHue = useMemo(() => {
if (color) {
const values = color.split("(")[1].split(")")[0].trim().split(/\s+/);
return parseFloat(values[2] || "0");
}
return Math.floor(Math.random() * 360);
}, [color]);
const randomColor = useMemo(() => {
if (color) {
return color;
}
return `oklch(${Math.min(lightness, 1)} ${saturation} ${randomHue})`;
}, [randomHue, saturation, lightness]);
const lightColor = useMemo(() => {
return `oklch(${Math.min(lightness * 2, 1)} ${saturation} ${randomHue})`;
}, [randomHue, saturation, lightness, color]);
const direction = useMemo(() => {
return Math.floor(Math.random() * 360);
}, [randomHue]);
const brightnessFilter = useMemo(() => {
return "1000%";
}, []);
return ;
};
View the source code for this module on GitHub: [https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp\_use/server/middleware/middleware.py](https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/server/middleware/middleware.py)
## CallNext
```python theme={null}
from mcp_use.server.middleware.middleware import CallNext
```
### `method` **init**
**Parameters**
> Parameter value
> Parameter value
**Signature**
```python wrap theme={null}
def __init__(args, kwargs):
```
### `method` **call**
**Parameters**
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def __call__(context: ServerMiddlewareContext[T]):
```
## Middleware
```python theme={null}
from mcp_use.server.middleware.middleware import Middleware
```
### `method` **call**
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def __call__(context: ServerMiddlewareContext[T], call_next: CallNext[T, Any]):
```
### `method` on\_call\_tool
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_call_tool(
context: ServerMiddlewareContext[CallToolRequestParams],
call_next: CallNext[CallToolRequestParams,
Any]
):
```
### `method` on\_complete
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_complete(
context: ServerMiddlewareContext[CompleteRequestParams],
call_next: CallNext[CompleteRequestParams,
Any]
):
```
### `method` on\_get\_prompt
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_get_prompt(
context: ServerMiddlewareContext[GetPromptRequestParams],
call_next: CallNext[GetPromptRequestParams,
Any]
):
```
### `method` on\_initialize
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_initialize(
context: ServerMiddlewareContext[InitializeRequestParams],
call_next: CallNext[InitializeRequestParams,
Any]
):
```
### `method` on\_list\_prompts
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_list_prompts(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
call_next: CallNext[PaginatedRequestParams | None,
Any]
):
```
### `method` on\_list\_resources
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_list_resources(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
call_next: CallNext[PaginatedRequestParams | None,
Any]
):
```
### `method` on\_list\_tools
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_list_tools(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
call_next: CallNext[PaginatedRequestParams | None,
Any]
):
```
### `method` on\_read\_resource
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_read_resource(
context: ServerMiddlewareContext[ReadResourceRequestParams],
call_next: CallNext[ReadResourceRequestParams,
Any]
):
```
### `method` on\_request
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_request(context: ServerMiddlewareContext[Any], call_next: CallNext[Any, Any]):
```
### `method` on\_set\_logging\_level
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_set_logging_level(
context: ServerMiddlewareContext[SetLevelRequestParams],
call_next: CallNext[SetLevelRequestParams,
Any]
):
```
### `method` on\_subscribe\_resource
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_subscribe_resource(
context: ServerMiddlewareContext[SubscribeRequestParams],
call_next: CallNext[SubscribeRequestParams,
Any]
):
```
### `method` on\_unsubscribe\_resource
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def on_unsubscribe_resource(
context: ServerMiddlewareContext[UnsubscribeRequestParams],
call_next: CallNext[UnsubscribeRequestParams,
Any]
):
```
## MiddlewareManager
```python theme={null}
from mcp_use.server.middleware.middleware import MiddlewareManager
```
### `method` **init**
**Signature**
```python wrap theme={null}
def __init__():
```
### `method` add\_middleware
**Parameters**
> Middleware instance
**Signature**
```python wrap theme={null}
def add_middleware(middleware: Middleware):
```
### `method` process\_request
**Parameters**
> Parameter value
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def process_request(
context: ServerMiddlewareContext[Any],
handler: Callable[[ServerMiddlewareContext[Any]],
Awaitable[Any]]
):
```
## ServerMiddlewareContext
class ServerMiddlewareContext
Immutable context passed through server middleware pipeline.
```python theme={null}
from mcp_use.server.middleware.middleware import ServerMiddlewareContext
```
**Attributes**
>
Parameter value
String value
Parameter value
String value
MCP session instance
Dictionary of key-value pairs
MCP client instance
Dictionary of key-value pairs
### `method` **init**
**Parameters**
> Parameter value
> String value
> Parameter value
> String value
> MCP session instance
> Dictionary of key-value pairs
> MCP client instance
> Dictionary of key-value pairs
**Signature**
```python wrap theme={null}
def __init__(message: T, method: str, timestamp: datetime, transport: str, session_id: str | None = None, headers: dict[str, str] | None = None, client_ip: str | None = None, metadata: dict[str, Any] = ):
```
### `method` copy
**Parameters**
> Parameter value
**Returns**
>
**Signature**
```python wrap theme={null}
def copy(kwargs: Any):
```
## ServerResponseContext
class ServerResponseContext
Optional response wrapper for middleware outputs.
```python theme={null}
from mcp_use.server.middleware.middleware import ServerResponseContext
```
**Attributes**
>
Parameter value
Parameter value
Dictionary of key-value pairs
### `method` **init**
**Parameters**
> Parameter value
> Parameter value
> Dictionary of key-value pairs
**Signature**
```python wrap theme={null}
def __init__(result: R | None = None, error: Exception | None = None, metadata: dict[str, Any] = ):
```