bb_get_commit_history

Retrieve commit history for a Bitbucket repository by workspace and repo slugs. Filter by branch, tag, commit hash, or file path, and manage pagination using limit and cursor. Outputs formatted Markdown with commit details.

Instructions

Retrieves the commit history for a repository identified by workspaceSlug and repoSlug. Supports pagination via limit (number of commits per page) and cursor (which acts as the page number for this endpoint). Optionally filters history starting from a specific branch, tag, or commit hash using revision, or shows only commits affecting a specific file using path. Returns the commit history as formatted Markdown, including commit hash, author, date, and message. Pagination details are included at the end of the text content. Requires Bitbucket credentials to be configured.

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Obtained from previous response when more results are available.
`limit`	No	Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted.
`path`	No	Optional file path to filter commit history. Only shows commits affecting this file.
`repoSlug`	Yes	Repository slug whose commit history is to be retrieved. Example: "project-api"
`revision`	No	Optional branch name, tag, or commit hash to view history from. If omitted, uses the default branch.
`workspaceSlug`	No	Workspace slug containing the repository. If not provided, the system will use your default workspace. 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. Obtained from previous response when more results are available.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted.",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "type": "integer"
    },
    "path": {
      "description": "Optional file path to filter commit history. Only shows commits affecting this file.",
      "type": "string"
    },
    "repoSlug": {
      "description": "Repository slug whose commit history is to be retrieved. Example: \"project-api\"",
      "minLength": 1,
      "type": "string"
    },
    "revision": {
      "description": "Optional branch name, tag, or commit hash to view history from. If omitted, uses the default branch.",
      "type": "string"
    },
    "workspaceSlug": {
      "description": "Workspace slug containing the repository. If not provided, the system will use your default workspace. Example: \"myteam\"",
      "type": "string"
    }
  },
  "required": [
    "repoSlug"
  ],
  "type": "object"
}

Atlassian Bitbucket MCP Server