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

# list_team_flags

Retrieve all feature flags for a team across all projects. The list can be filtered by state and supports pagination.

## Parameters

| Parameter      | Type             | Required | Description                                                                                                                                                                                                          |
| -------------- | ---------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `state`        | string           | No       | The state of the flags to retrieve. Defaults to `active`. Allowed values: `"active"`, `"archived"`.                                                                                                                  |
| `withMetadata` | boolean          | No       | Deprecated. Whether to include creator metadata in each flag in the response. Resolve creator identity client-side (e.g. via the team members endpoint) instead. This parameter will be removed in a future release. |
| `limit`        | integer          | No       | Maximum number of flags to return. Minimum: 1. Maximum: 100. Default: `20`.                                                                                                                                          |
| `cursor`       | string           | No       | Pagination cursor to continue from.                                                                                                                                                                                  |
| `search`       | string           | No       | Search flags by their slug or description. Case-insensitive.                                                                                                                                                         |
| `kind`         | string           | No       | The kind of flags to retrieve. Allowed values: `"boolean"`, `"string"`, `"number"`, `"json"`.                                                                                                                        |
| `tags`         | Array\<string> | No       | Filter flags by tag. Repeat the parameter for multiple tags (all must match).                                                                                                                                        |
| `teamId`       | string           | Yes      | Team ID to use for this operation.                                                                                                                                                                                   |
| `slug`         | string           | No       | Team slug to use for this operation. Use instead of teamId.                                                                                                                                                          |


---

[View full sitemap](/docs/sitemap)