Skip to main content

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.

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

​
Context

from mcp_use.server.context import Context

​
method init

Parameters
​
request_context
RequestContext[ServerSessionT, LifespanContextT, RequestT] | None
default:"None"
Parameter value
​
fastmcp
FastMCP | None
default:"None"
Parameter value
​
kwargs
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
​
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
​
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
​
messages
str | SamplingMessage | Sequence[SamplingMessage | str]
required
The sampling prompt(s). Accepts a simple string, a single
​
max_tokens
int
default:"512"
Maximum number of tokens to request from the client LLM.
​
system_prompt
str | None
default:"None"
Optional system instructions to prepend.
​
include_context
bool | None
default:"None"
Whether to ask the client to include MCP context.
​
temperature
float | None
default:"None"
Optional sampling temperature.
​
stop_sequences
Sequence[str] | None
default:"None"
Optional stop sequences to pass to the client LLM.
​
metadata
dict[str, Any] | None
default:"None"
Optional provider-specific metadata.
​
model_preferences
ModelPreferences | None
default:"None"
Optional hint about the desired model.
​
raw
bool
default:"False"
When True returns the full CreateMessageResult instead of
Returns
​
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():