Context

View the source code for this module on GitHub: https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/server/context.py

from mcp_use.server.context import Context

`method` init

Parameters

RequestContext[ServerSessionT, LifespanContextT, RequestT] | None
default:"None"
Parameter value

FastMCP | None
default:"None"
Parameter value

Any
required
Parameter value

Signature

def __init__(request_context: RequestContext[ServerSessionT, LifespanContextT, RequestT] | None = None, fastmcp: FastMCP | None = None, kwargs: Any):

`method` get_http_request

Return the underlying Starlette Request when running over HTTP transports.Returns

Request | None

Signature

def get_http_request():

`method` list_roots

Request the list of roots from the client.Roots represent directories or files that the client has access to and wants to make available to the server.Example:

@mcp.tool()
async def analyze_workspace(ctx: Context) -> str:
    roots = await ctx.list_roots()
    if not roots:
        return "No roots provided by client"
    return f"Client has \{len(roots)\} root(s): \{[str(r.uri) for r in roots]\}"

Returns

list[Root]
A list of Root objects, each with a ‘uri’ (file:// URI) and optional ‘name’ field.

Signature

def list_roots():

`method` sample

Request a client-side LLM sampling invocation.Parameters

str | SamplingMessage | Sequence[SamplingMessage | str]
required
The sampling prompt(s). Accepts a simple string, a single

int
default:"512"
Maximum number of tokens to request from the client LLM.

str | None
default:"None"
Optional system instructions to prepend.

bool | None
default:"None"
Whether to ask the client to include MCP context.

float | None
default:"None"
Optional sampling temperature.

Sequence[str] | None
default:"None"
Optional stop sequences to pass to the client LLM.

dict[str, Any] | None
default:"None"
Optional provider-specific metadata.

ModelPreferences | None
default:"None"
Optional hint about the desired model.

bool
default:"False"
When True returns the full CreateMessageResult instead of

Returns

CreateMessageResult

Signature

def sample(
messages: str | SamplingMessage | Sequence[SamplingMessage | str],
    max_tokens: int = 512,
    system_prompt: str | None = None,
    include_context: bool | None = None,
    temperature: float | None = None,
    stop_sequences: Sequence[str] | None = None,
    metadata: dict[str,
    Any] | None = None,
    model_preferences: ModelPreferences | None = None,
    raw: bool = False
):

`method` send_prompt_list_changed

Notify the client that the prompt list changed.Signature

def send_prompt_list_changed():

`method` send_resource_list_changed

Notify the client that the resource list changed.Signature

def send_resource_list_changed():

`method` send_tool_list_changed

Notify the client that the tool list changed.Signature

def send_tool_list_changed():

Agents

Client

Core

Errors

Server

Context

Context

`method` init

`method` get_http_request

`method` list_roots

`method` sample

`method` send_prompt_list_changed

`method` send_resource_list_changed

`method` send_tool_list_changed

​Context

​method init

​method get_http_request

​method list_roots

​method sample

​method send_prompt_list_changed

​method send_resource_list_changed

​method send_tool_list_changed

Context

`method` init

`method` get_http_request

`method` list_roots

`method` sample

`method` send_prompt_list_changed

`method` send_resource_list_changed

`method` send_tool_list_changed