{
  "name": "io.github.atlassian/mcp-server-atlassian",
  "description": "The Atlassian Bitbucket MCP connects an AI agent to a Bitbucket Cloud workspace. Lists repositories, reads files and diffs, opens and reviews pull requests, inspects Bitbucket Pipelines runs, and manages branch restrictions. Built for teams that live in the Atlassian stack — Bitbucket plus Jira plus Confluence — and want a consistent agent surface across all three.",
  "status": "active",
  "version": "latest",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-06-02",
    "com.top-mcps/score": {
      "value": 64,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-02T13:16:41.657Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-02T13:16:41.167Z"
    }
  },
  "repository": {
    "url": "https://github.com/atlassian/mcp-server-atlassian",
    "source": "github"
  },
  "author": {
    "name": "Atlassian"
  },
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "run",
      "version": "latest",
      "transport": {
        "type": "stdio"
      },
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "--rm"
        },
        {
          "type": "positional",
          "value": "-i"
        },
        {
          "type": "positional",
          "value": "-e"
        },
        {
          "type": "positional",
          "value": "BITBUCKET_USERNAME"
        },
        {
          "type": "positional",
          "value": "-e"
        },
        {
          "type": "positional",
          "value": "BITBUCKET_APP_PASSWORD"
        },
        {
          "type": "positional",
          "value": "-e"
        },
        {
          "type": "positional",
          "value": "BITBUCKET_WORKSPACE"
        },
        {
          "type": "positional",
          "value": "ghcr.io/atlassian/mcp-server-atlassian:latest"
        }
      ],
      "environmentVariables": [
        {
          "name": "BITBUCKET_USERNAME",
          "description": "BITBUCKET_USERNAME — required credential for Bitbucket.",
          "isRequired": true,
          "isSecret": true
        },
        {
          "name": "BITBUCKET_APP_PASSWORD",
          "description": "BITBUCKET_APP_PASSWORD — required credential for Bitbucket.",
          "isRequired": true,
          "isSecret": true
        },
        {
          "name": "BITBUCKET_WORKSPACE",
          "description": "BITBUCKET_WORKSPACE — required credential for Bitbucket.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "list_repos",
        "description": "List repositories in a workspace.",
        "sideEffect": "read",
        "args": [
          {
            "name": "workspace",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "get_pull_request",
        "description": "Return metadata, files, and reviewers for a PR.",
        "sideEffect": "read",
        "args": [
          {
            "name": "workspace",
            "type": "string",
            "required": true
          },
          {
            "name": "repo",
            "type": "string",
            "required": true
          },
          {
            "name": "id",
            "type": "number",
            "required": true
          }
        ]
      },
      {
        "name": "list_pipelines",
        "description": "List recent Pipelines runs for a repo.",
        "sideEffect": "read",
        "args": [
          {
            "name": "workspace",
            "type": "string",
            "required": true
          },
          {
            "name": "repo",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "create_comment",
        "description": "Add a comment on a PR. Requires write scope.",
        "sideEffect": "write",
        "args": [
          {
            "name": "pr_id",
            "type": "number",
            "required": true
          },
          {
            "name": "body",
            "type": "string",
            "required": true
          }
        ]
      }
    ],
    "security": {
      "scope": "read-only",
      "sandbox": "Authenticates with a Bitbucket app password or OAuth token scoped to the smallest set of permissions the workflow needs. The MCP defaults to read-only tools.",
      "gotchas": [
        "App passwords with admin scope can delete branches; scope them to repo:read for agent use.",
        "OAuth grants are workspace-wide — review which workspaces you authorise before consent.",
        "Bitbucket rate-limits at 1000 requests/hour per user; a chatty agent can exhaust the budget on large workspaces."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/bitbucket",
    "markdown": "https://top-mcps.com/mcp/bitbucket.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}