> ## Documentation Index
> Fetch the complete documentation index at: https://gofastmcp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# resources

# `fastmcp.client.mixins.resources`

Resource-related methods for FastMCP Client.

## Classes

### `ClientResourcesMixin` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L23](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L23)</sup>

Mixin providing resource-related methods for Client.

**Methods:**

#### `list_resources_mcp` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L28](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L28)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
list_resources_mcp(self: Client) -> mcp_types.ListResourcesResult
```

Send a resources/list request and return the complete MCP protocol result.

**Args:**

* `cursor`: Optional pagination cursor from a previous request's nextCursor.
* `cache_mode`: Response-cache behavior (only active with a cache and a modern
  connection). See `list_tools_mcp`.

**Returns:**

* mcp\_types.ListResourcesResult: The complete response object from the protocol,
  containing the list of resources and any additional metadata.

**Raises:**

* `RuntimeError`: If called while the client is not connected.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError

#### `list_resources` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L72](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L72)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
list_resources(self: Client, max_pages: int = AUTO_PAGINATION_MAX_PAGES) -> list[mcp_types.Resource]
```

Retrieve all resources available on the server.

This method automatically fetches all pages if the server paginates results,
returning the complete list. For manual pagination control (e.g., to handle
large result sets incrementally), use list\_resources\_mcp() with the cursor parameter.

**Args:**

* `max_pages`: Maximum number of pages to fetch before raising. Defaults to 250.

**Returns:**

* list\[mcp\_types.Resource]: A list of all Resource objects.

**Raises:**

* `RuntimeError`: If the page limit is reached before pagination completes.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError

#### `list_resource_templates_mcp` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L119](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L119)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
list_resource_templates_mcp(self: Client) -> mcp_types.ListResourceTemplatesResult
```

Send a resources/listResourceTemplates request and return the complete MCP protocol result.

**Args:**

* `cursor`: Optional pagination cursor from a previous request's nextCursor.
* `cache_mode`: Response-cache behavior (only active with a cache and a modern
  connection). See `list_tools_mcp`.

**Returns:**

* mcp\_types.ListResourceTemplatesResult: The complete response object from the protocol,
  containing the list of resource templates and any additional metadata.

**Raises:**

* `RuntimeError`: If called while the client is not connected.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError

#### `list_resource_templates` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L166](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L166)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
list_resource_templates(self: Client, max_pages: int = AUTO_PAGINATION_MAX_PAGES) -> list[mcp_types.ResourceTemplate]
```

Retrieve all resource templates available on the server.

This method automatically fetches all pages if the server paginates results,
returning the complete list. For manual pagination control (e.g., to handle
large result sets incrementally), use list\_resource\_templates\_mcp() with the
cursor parameter.

**Args:**

* `max_pages`: Maximum number of pages to fetch before raising. Defaults to 250.

**Returns:**

* list\[mcp\_types.ResourceTemplate]: A list of all ResourceTemplate objects.

**Raises:**

* `RuntimeError`: If the page limit is reached before pagination completes.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError

#### `read_resource_mcp` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L215](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L215)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
read_resource_mcp(self: Client, uri: AnyUrl | str, meta: dict[str, Any] | None = None) -> mcp_types.ReadResourceResult
```

Send a resources/read request and return the complete MCP protocol result.

**Args:**

* `uri`: The URI of the resource to read. Can be a string or an AnyUrl object.
* `meta`: Request metadata (e.g., for SEP-1686 tasks). Defaults to None.

**Returns:**

* mcp\_types.ReadResourceResult: The complete response object from the protocol,
  containing the resource contents and any additional metadata.

**Raises:**

* `RuntimeError`: If called while the client is not connected.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError

#### `read_resource` <sup>[https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp\_slim/fastmcp/client/mixins/resources.py#L267](https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/mixins/resources.py#L267)</sup>

```python theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
read_resource(self: Client, uri: AnyUrl | str) -> list[mcp_types.TextResourceContents | mcp_types.BlobResourceContents]
```

Read the contents of a resource or resolved template.

**Args:**

* `uri`: The URI of the resource to read. Can be a string or an AnyUrl object.
* `version`: Specific version to read. If None, reads highest version.
* `meta`: Optional request-level metadata.

**Returns:**

* list\[mcp\_types.TextResourceContents | mcp\_types.BlobResourceContents]:
  A list of content objects.

**Raises:**

* `RuntimeError`: If called while the client is not connected.
* `MCPError`: If the request results in a TimeoutError | JSONRPCError


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.