> ## Documentation Index

> Fetch the complete documentation index at: /llms.txt

> Use this file to discover all available pages before exploring further.

Skip to main content
Operations

# Client Roots

Provide local context and resource boundaries to MCP servers.

New in version `2.0.0` Use this when you need to tell servers what local resources the client has access to. Roots inform servers about resources the client can provide. Servers can use this information to adjust behavior or provide more relevant responses.

##
​
Static Roots

Provide a list of roots when creating the client:

    from fastmcp import Client

    client = Client(
        "my_mcp_server.py",
        roots=["/path/to/root1", "/path/to/root2"]
    )

##
​
Dynamic Roots

Use a callback to compute roots dynamically when the server requests them:

    from fastmcp import Client
    from fastmcp.client.roots import RequestContext

    async def roots_callback(context: RequestContext) -> list[str]:
        print(f"Server requested roots (Request ID: {context.request_id})")
        return ["/path/to/root1", "/path/to/root2"]

    client = Client(
        "my_mcp_server.py",
        roots=roots_callback
    )

Server Logging
Previous
Notifications
Next
⌘I
Assistant
Responses are generated using AI and may contain mistakes.