list-repositories

Discover and navigate Bitbucket repositories within a workspace by listing their slugs, names, and URLs. Use this tool to explore code resources, check visibility, or filter repositories by language, size, or other characteristics.

Instructions

List Bitbucket repositories within a specific workspace.

PURPOSE: Discovers repositories in a workspace with their slugs, names, and URLs to help navigate code resources.

WHEN TO USE:

When you need to find repositories within a specific workspace
When you need repository slugs for other Bitbucket operations
When you want to explore available repositories before accessing specific content
When you need to check repository visibility and access levels
When looking for repositories with specific characteristics (language, size, etc.)

WHEN NOT TO USE:

When you don't know which workspace to look for repos in (use list-workspaces first)
When you already know the repository slug (use get-repository instead)
When you need detailed repository information (use get-repository instead)
When you need to access pull requests or branches (use dedicated tools after identifying the repo)

RETURNS: Formatted list of repositories with slugs, names, descriptions, URLs, and metadata, plus pagination info.

EXAMPLES:

List all repos in workspace: {workspace: "myteam"}
With sorting: {workspace: "myteam", sort: "name"}
With filtering: {workspace: "myteam", query: "api"}
With pagination: {workspace: "myteam", limit: 10, cursor: "next-page-token"}

ERRORS:

Workspace not found: Verify the workspace slug is correct
Authentication failures: Check your Bitbucket credentials
Permission errors: Ensure you have access to the requested workspace
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 repositories to return (1-100). Use this to control the response size. If omitted, defaults to 25.
`q`	No	Query string to filter repositories using Bitbucket query syntax. Example: "name ~ \"api\"" for repositories with "api" in the name. If omitted, returns all repositories.
`role`	No	Filter repositories by the authenticated user's role. Common values: "owner", "admin", "contributor", "member". If omitted, returns repositories of all roles.
`sort`	No	Field to sort results by. Common values: "name", "created_on", "updated_on". Prefix with "-" for descending order. Example: "-updated_on" for most recently updated first.
`workspace`	Yes	Workspace slug containing the repositories. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"

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 repositories 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 repositories using Bitbucket query syntax. Example: \"name ~ \\\"api\\\"\" for repositories with \"api\" in the name. If omitted, returns all repositories.",
      "type": "string"
    },
    "role": {
      "description": "Filter repositories by the authenticated user's role. Common values: \"owner\", \"admin\", \"contributor\", \"member\". If omitted, returns repositories of all roles.",
      "type": "string"
    },
    "sort": {
      "description": "Field to sort results by. Common values: \"name\", \"created_on\", \"updated_on\". Prefix with \"-\" for descending order. Example: \"-updated_on\" for most recently updated first.",
      "type": "string"
    },
    "workspace": {
      "description": "Workspace slug containing the repositories. Must be a valid workspace slug from your Bitbucket account. Example: \"myteam\"",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "workspace"
  ],
  "type": "object"
}

Atlassian Bitbucket MCP Server