---
title: list_sessions
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/sandboxes/list_sessions
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/sandboxes/list_sessions"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/sandboxes
  - /docs/agent-resources/vercel-mcp/tools
related:
  []
summary: Use list_sessions with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# list_sessions

List sessions.

## Parameters

| Parameter   | Type   | Required | Description                                                                                        |
| ----------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| `project`   | string | Yes      | The unique identifier or name of the project to list sessions for.                                 |
| `name`      | string | No       | Filter sessions by sandbox name. Only sessions belonging to the specified sandbox are returned.    |
| `limit`     | number | No       | Maximum number of sessions to return in the response. Used for pagination. Default: `20`.          |
| `cursor`    | string | No       | Opaque pagination cursor from a previous response.                                                 |
| `sortOrder` | string | No       | Sort direction for results by creation time. Allowed values: `"asc"`, `"desc"`. Default: `"desc"`. |
| `teamId`    | string | No       | Team ID.                                                                                           |
| `slug`      | string | No       | Team slug.                                                                                         |


---

[View full sitemap](/docs/sitemap)