mcp server atlassian bitbucket

[
  {
    "description": "List Bitbucket workspaces available to your account.nnPURPOSE: Discovers workspaces you have access to with their slugs, names, and permission levels to help navigate Bitbucket's organization structure.nnWHEN TO USE:n- When you need to discover what workspaces exist in your Bitbucket accountn- When you want to find the slugs needed for other Bitbucket operationsn- When you need to check what workspaces you have access to and their permission levelsn- Before accessing repositories or pull requests that require workspace informationn- When you're unfamiliar with the workspace organization structurennWHEN NOT TO USE:n- When you already know the workspace slug (use get-workspace or list-repositories instead)n- When you need detailed workspace information (use get-workspace instead)n- When you need to find specific repositories (use list-repositories after identifying the workspace)nnRETURNS: Formatted list of workspaces with slugs, names, and permission information, plus pagination details if available.nnEXAMPLES:n- List all workspaces: {}n- With sorting: {sort: "name"}n- With pagination: {limit: 10, cursor: "next-page-token"}nnERRORS:n- Authentication failures: Check your Bitbucket credentialsn- No workspaces found: You might not have access to any workspacesn- Rate limiting: Use pagination and reduce query frequency",
    "inputSchema": {
      "$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"
    },
    "name": "list-workspaces"
  },
  {
    "description": "Get detailed information about a specific Bitbucket workspace by slug.nnPURPOSE: Retrieves comprehensive workspace metadata including projects, permissions, and configuration.nnWHEN TO USE:n- When you need detailed information about a specific workspacen- When you need to check workspace permissions or membershipn- When you need to verify workspace settings or configurationn- After using list-workspaces to identify the relevant workspacen- Before performing operations that require detailed workspace contextnnWHEN NOT TO USE:n- When you don't know which workspace to look for (use list-workspaces first)n- When you just need basic workspace information (slug, name)n- When you're only interested in repositories (use list-repositories directly)nnRETURNS: Detailed workspace information including slug, name, type, description, projects, and permission levels.nnEXAMPLES:n- Get workspace: {workspace: "myteam"}nnERRORS:n- Workspace not found: Verify the workspace slug is correctn- Permission errors: Ensure you have access to the requested workspacen- Rate limiting: Cache workspace information when possible",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "workspace": {
          "description": "Workspace slug to retrieve detailed information for. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "workspace"
      ],
      "type": "object"
    },
    "name": "get-workspace"
  },
  {
    "description": "List Bitbucket repositories within a specific workspace.nnPURPOSE: Discovers repositories in a workspace with their slugs, names, and URLs to help navigate code resources.nnWHEN TO USE:n- When you need to find repositories within a specific workspacen- When you need repository slugs for other Bitbucket operationsn- When you want to explore available repositories before accessing specific contentn- When you need to check repository visibility and access levelsn- When looking for repositories with specific characteristics (language, size, etc.)nnWHEN NOT TO USE:n- When you don't know which workspace to look for repos in (use list-workspaces first)n- When you already know the repository slug (use get-repository instead)n- When you need detailed repository information (use get-repository instead)n- When you need to access pull requests or branches (use dedicated tools after identifying the repo)nnRETURNS: Formatted list of repositories with slugs, names, descriptions, URLs, and metadata, plus pagination info.nnEXAMPLES:n- List all repos in workspace: {workspace: "myteam"}n- With sorting: {workspace: "myteam", sort: "name"}n- With filtering: {workspace: "myteam", query: "api"}n- With pagination: {workspace: "myteam", limit: 10, cursor: "next-page-token"}nnERRORS:n- Workspace not found: Verify the workspace slug is correctn- Authentication failures: Check your Bitbucket credentialsn- Permission errors: Ensure you have access to the requested workspacen- Rate limiting: Use pagination and reduce query frequency",
    "inputSchema": {
      "$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"
    },
    "name": "list-repositories"
  },
  {
    "description": "Get detailed information about a specific Bitbucket repository.nnPURPOSE: Retrieves comprehensive repository metadata including branches, settings, permissions, and more.nnWHEN TO USE:n- When you need detailed information about a specific repositoryn- When you need repository URLs, clone links, or other reference informationn- When you need to check repository settings or permissionsn- After using list-repositories to identify the relevant repositoryn- Before performing operations that require repository context (PRs, branches)nnWHEN NOT TO USE:n- When you don't know which repository to look for (use list-repositories first)n- When you just need basic repository informationn- When you're looking for pull request details (use list-pullrequests instead)n- When you need content from multiple repositories (use list-repositories instead)nnRETURNS: Detailed repository information including slug, name, description, URLs, branch information, and settings.nnEXAMPLES:n- Get repository: {workspace: "myteam", repoSlug: "project-api"}nnERRORS:n- Repository not found: Verify workspace and repository slugsn- Permission errors: Ensure you have access to the requested repositoryn- Rate limiting: Cache repository information when possible",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "includeBranches": {
          "description": "When true, includes information about repository branches in the response. If omitted, defaults to false.",
          "type": "boolean"
        },
        "includeCommits": {
          "description": "When true, includes recent commits information in the response. If omitted, defaults to false.",
          "type": "boolean"
        },
        "includePullRequests": {
          "description": "When true, includes open pull requests information in the response. If omitted, defaults to false.",
          "type": "boolean"
        },
        "repoSlug": {
          "description": "Repository slug to retrieve. This must be a valid repository in the specified workspace. Example: "project-api"",
          "minLength": 1,
          "type": "string"
        },
        "workspace": {
          "description": "Workspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "workspace",
        "repoSlug"
      ],
      "type": "object"
    },
    "name": "get-repository"
  },
  {
    "description": "List Bitbucket pull requests with optional filtering capabilities.nnPURPOSE: Allows you to find and browse pull requests across repositories with filtering options.nnWHEN TO USE:n- When you need to find pull requests within a specific repositoryn- When you want to check PR status (open, merged, declined, etc.)n- When you need to track code review activity and progressn- When you need PR IDs for other Bitbucket operationsn- When monitoring contributions from specific authorsnnWHEN NOT TO USE:n- When you don't know which repository to look in (use list-repositories first)n- When you already know the PR ID (use get-pull-request instead)n- When you need detailed PR content or comments (use get-pull-request instead)n- When you need to browse repositories rather than PRs (use list-repositories)nnRETURNS: Formatted list of pull requests with IDs, titles, states, authors, branch information, and URLs, plus pagination info.nnEXAMPLES:n- List all PRs in a repo: {workspace: "myteam", repoSlug: "project-api"}n- Filter by state: {workspace: "myteam", repoSlug: "project-api", state: "OPEN"}n- With pagination: {workspace: "myteam", repoSlug: "project-api", limit: 10, cursor: "next-page-token"}nnERRORS:n- Repository not found: Verify workspace and repository slugsn- Authentication failures: Check your Bitbucket credentialsn- Permission errors: Ensure you have access to the requested repositoryn- Rate limiting: Use pagination and reduce query frequency",
    "inputSchema": {
      "$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 pull requests to return (1-100). Use this to control the response size. If omitted, defaults to 25.",
          "exclusiveMinimum": 0,
          "maximum": 100,
          "type": "integer"
        },
        "repoSlug": {
          "description": "Repository slug containing the pull requests. This must be a valid repository in the specified workspace. Example: "project-api"",
          "minLength": 1,
          "type": "string"
        },
        "state": {
          "description": "Filter pull requests by state. Options: "OPEN" (active PRs), "MERGED" (completed PRs), "DECLINED" (rejected PRs), or "SUPERSEDED" (replaced PRs). If omitted, defaults to showing all states.",
          "enum": [
            "OPEN",
            "MERGED",
            "DECLINED",
            "SUPERSEDED"
          ],
          "type": "string"
        },
        "workspace": {
          "description": "Workspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "workspace",
        "repoSlug"
      ],
      "type": "object"
    },
    "name": "list-pull-requests"
  },
  {
    "description": "Get detailed information about a specific Bitbucket pull request.nnPURPOSE: Retrieves comprehensive PR data including description, comments, diff stats, reviewers, and branch information.nnWHEN TO USE:n- When you need the full description and context of a specific PRn- When you need to see comments, reviews, or approvalsn- When you need details about the source and destination branchesn- When you need diff statistics or changed files informationn- After using list-pull-requests to identify the relevant PR IDnnWHEN NOT TO USE:n- When you don't know which PR to look for (use list-pull-requests first)n- When you need to browse multiple PRs (use list-pull-requests instead)n- When you only need basic PR information without comments or detailsn- When you need repository information rather than PR details (use get-repository)nnRETURNS: Detailed PR information including title, description, status, author, reviewers, branches, comments, and related timestamps.nnEXAMPLES:n- Get PR details: {workspace: "myteam", repoSlug: "project-api", id: 42}nnERRORS:n- PR not found: Verify workspace, repository slugs, and PR IDn- Permission errors: Ensure you have access to the requested PRn- Rate limiting: Cache PR information when possible for frequently referenced PRs",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "includeComments": {
          "description": "Whether to include comments in the response. When true, includes all comments on the pull request. If omitted, defaults to false.",
          "type": "boolean"
        },
        "pullRequestId": {
          "description": "Numeric ID of the pull request to retrieve. Must be a valid pull request ID in the specified repository. Example: 42",
          "exclusiveMinimum": 0,
          "type": "integer"
        },
        "repoSlug": {
          "description": "Repository slug containing the pull request. This must be a valid repository in the specified workspace. Example: "project-api"",
          "minLength": 1,
          "type": "string"
        },
        "workspace": {
          "description": "Workspace slug containing the repository. Must be a valid workspace slug from your Bitbucket account. Example: "myteam"",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "workspace",
        "repoSlug",
        "pullRequestId"
      ],
      "type": "object"
    },
    "name": "get-pull-request"
  }
]