--- title: list_flags product: vercel url: /docs/agent-resources/vercel-mcp/tools/feature-flags/list_flags canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/feature-flags/list_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_flags with Vercel MCP. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # list_flags List flags. ## Parameters | Parameter | Type | Required | Description | | ----------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `projectIdOrName` | string | Yes | The project id or name | | `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. Use `GET /v1/projects/:id/feature-flags/flags/:flagIdOrSlug?withMetadata=true` for single-flag lookups that need creator metadata. | | `limit` | integer | No | Maximum number of flags to return. When not set, all flags are returned. | | `cursor` | string | No | Pagination cursor to continue from. | | `search` | string | No | Search flags by their slug or description. Case-insensitive. | | `tags` | Array\ | No | Filter flags by tag. Repeat the parameter for multiple tags (all must match). | | `teamId` | string | No | Team ID. | | `slug` | string | No | Team slug. | --- [View full sitemap](/docs/sitemap)