bb_search

bb_search

Search Bitbucket repositories, code, pull requests, or content within a specified workspace or repository. Filter results by language, file extension, or content type, and manage large result sets with pagination. Requires Bitbucket credentials.

Instructions

Searches Bitbucket for content matching the provided query. Use this tool to find repositories, code, pull requests, or other content in Bitbucket. Specify scope to narrow your search ("code", "repositories", "pullrequests", or "content"). Filter code searches by language or extension. Filter content searches by contentType. Only searches within the specified workspaceSlug and optionally within a specific repoSlug. Supports pagination via limit and cursor. Requires Atlassian Bitbucket credentials configured. Returns search results as Markdown.

Input Schema

Name	Required	Description	Default
`contentType`	No	Content type for content search (e.g., "wiki", "issue"). Equivalent to --content-type in CLI.
`cursor`	No	Pagination cursor for retrieving the next set of results. For repositories and pull requests, this is a cursor string. For code search, this is a page number. Use this to navigate through large result sets.
`extension`	No	Filter code search by file extension. Equivalent to --extension in CLI.
`language`	No	Filter code search by language. Equivalent to --language in CLI.
`limit`	No	Maximum number of results to return (1-100). Use this to control the response size. Useful for pagination or when you only need a few results.
`query`	Yes	Search query text. Required. Will match against content based on the selected search scope. Equivalent to --query in CLI.
`repoSlug`	No	Optional: Repository slug to limit search scope. Required for `pullrequests` scope. Example: "project-api". Equivalent to --repo in CLI.
`scope`	No	Search scope: "code", "content", "repositories", "pullrequests". Default: "code". Equivalent to --type in CLI.	code
`workspaceSlug`	No	Workspace slug to search in. If not provided, the system will use your default workspace. Example: "myteam". Equivalent to --workspace in CLI.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "contentType": {
      "description": "Content type for content search (e.g., \"wiki\", \"issue\"). Equivalent to --content-type in CLI.",
      "type": "string"
    },
    "cursor": {
      "description": "Pagination cursor for retrieving the next set of results. For repositories and pull requests, this is a cursor string. For code search, this is a page number. Use this to navigate through large result sets.",
      "type": "string"
    },
    "extension": {
      "description": "Filter code search by file extension. Equivalent to --extension in CLI.",
      "type": "string"
    },
    "language": {
      "description": "Filter code search by language. Equivalent to --language in CLI.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of results to return (1-100). Use this to control the response size. Useful for pagination or when you only need a few results.",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "query": {
      "description": "Search query text. Required. Will match against content based on the selected search scope. Equivalent to --query in CLI.",
      "minLength": 1,
      "type": "string"
    },
    "repoSlug": {
      "description": "Optional: Repository slug to limit search scope. Required for `pullrequests` scope. Example: \"project-api\". Equivalent to --repo in CLI.",
      "type": "string"
    },
    "scope": {
      "default": "code",
      "description": "Search scope: \"code\", \"content\", \"repositories\", \"pullrequests\". Default: \"code\". Equivalent to --type in CLI.",
      "enum": [
        "code",
        "content",
        "repositories",
        "pullrequests"
      ],
      "type": "string"
    },
    "workspaceSlug": {
      "description": "Workspace slug to search in. If not provided, the system will use your default workspace. Example: \"myteam\". Equivalent to --workspace in CLI.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Atlassian Bitbucket MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Atlassian Bitbucket MCP Server

Related Tools

MCP directory API