Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/api/search.ts:10-19 (handler)

  The core handler function that performs the Bitbucket API call to search for code in a workspace.
  async searchCode(params: SearchCodeParams): Promise<PaginatedResponse<BitbucketSearchResult>> { const { workspace, search_query, ...queryParams } = params; return this.client.get<PaginatedResponse<BitbucketSearchResult>>( `/workspaces/${workspace}/search/code`, { search_query, ...queryParams, } as Record<string, string | number | undefined> ); }
• src/tools/index.ts:847-860 (registration)

  Registration of the 'search_code' tool in the toolDefinitions array for MCP, including name, description, and inputSchema.
  { name: 'search_code', description: 'Search for code across all repositories in a workspace.', inputSchema: { type: 'object' as const, properties: { workspace: { type: 'string', description: 'The workspace slug' }, search_query: { type: 'string', description: 'Search query string' }, page: { type: 'number', description: 'Page number' }, pagelen: { type: 'number', description: 'Results per page' }, }, required: ['workspace', 'search_query'], }, },
• src/tools/index.ts:289-294 (schema)

  Zod schema used for input validation and parsing in the tool handler.
  search_code: z.object({ workspace: z.string().describe('The workspace slug'), search_query: z.string().describe('Search query string'), page: z.number().optional().describe('Page number'), pagelen: z.number().optional().describe('Results per page'), }),
• src/tools/index.ts:1078-1081 (helper)

  Dispatcher logic in ToolHandler.handleTool that parses arguments and delegates to the SearchAPI.searchCode method.
  case 'search_code': { const params = toolSchemas.search_code.parse(args); return this.search.searchCode(params); }
• src/types/index.ts:371-376 (schema)

  TypeScript interface defining the parameters for the search_code tool.
  export interface SearchCodeParams { workspace: string; search_query: string; page?: number; pagelen?: number; }