list-workspaces

Discover and list Bitbucket workspaces accessible to your account, including slugs, names, and permission levels. Use to navigate workspace structure or gather slugs for other Bitbucket operations. Supports filtering, sorting, and pagination.

Instructions

List Bitbucket workspaces available to your account.

PURPOSE: Discovers workspaces you have access to with their slugs, names, and permission levels to help navigate Bitbucket's organization structure.

WHEN TO USE:

When you need to discover what workspaces exist in your Bitbucket account
When you want to find the slugs needed for other Bitbucket operations
When you need to check what workspaces you have access to and their permission levels
Before accessing repositories or pull requests that require workspace information
When you're unfamiliar with the workspace organization structure

WHEN NOT TO USE:

When you already know the workspace slug (use get-workspace or list-repositories instead)
When you need detailed workspace information (use get-workspace instead)
When you need to find specific repositories (use list-repositories after identifying the workspace)

RETURNS: Formatted list of workspaces with slugs, names, and permission information, plus pagination details if available.

EXAMPLES:

List all workspaces: {}
With sorting: {sort: "name"}
With pagination: {limit: 10, cursor: "next-page-token"}

ERRORS:

Authentication failures: Check your Bitbucket credentials
No workspaces found: You might not have access to any workspaces
Rate limiting: Use pagination and reduce query frequency

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Obtain this value from the previous response when more results are available.
`limit`	No	Maximum number of workspaces to return (1-100). Use this to control the response size. If omitted, defaults to 25.
`q`	No	Query string to filter workspaces by name. Performs a partial text match on workspace names. Example: "team" would match "my-team" and "team-project". If omitted, returns all accessible workspaces.
`sort`	No	Field to sort results by. Common values: "name", "created_on", "updated_on". Prefix with "-" for descending order. Example: "-name" for reverse alphabetical order. If omitted, defaults to server-defined ordering.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "Pagination cursor for retrieving the next set of results. Obtain this value from the previous response when more results are available.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of workspaces to return (1-100). Use this to control the response size. If omitted, defaults to 25.",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "type": "integer"
    },
    "q": {
      "description": "Query string to filter workspaces by name. Performs a partial text match on workspace names. Example: \"team\" would match \"my-team\" and \"team-project\". If omitted, returns all accessible workspaces.",
      "type": "string"
    },
    "sort": {
      "description": "Field to sort results by. Common values: \"name\", \"created_on\", \"updated_on\". Prefix with \"-\" for descending order. Example: \"-name\" for reverse alphabetical order. If omitted, defaults to server-defined ordering.",
      "type": "string"
    }
  },
  "type": "object"
}

Atlassian Bitbucket MCP Server

list-workspaces

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Atlassian Bitbucket MCP Server

Related Tools