merge_pull_request

Instructions

Implementation Reference

• src/index.ts:722-746 (handler)

  The primary handler function that executes the merge_pull_request tool logic by making a POST request to Bitbucket's merge endpoint with optional message and strategy.

  private async mergePullRequest(params: PullRequestParams, options: MergeOptions = {}) {
    const { project, repository, prId } = params;
    
    if (!project || !repository || !prId) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Project, repository, and prId are required'
      );
    }
    
    const { message, strategy = 'merge-commit' } = options;
    
    const response = await this.api.post(
      `/projects/${project}/repos/${repository}/pull-requests/${prId}/merge`,
      {
        version: -1,
        message,
        strategy
      }
    );
  
    return {
      content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }]
    };
  }

• src/index.ts:223-241 (registration)

  Tool registration in the MCP server's tool list, defining the name, description, and input schema for merge_pull_request.

  {
    name: 'merge_pull_request',
    description: 'Merge an approved pull request into the target branch. Use this when a PR has been reviewed, approved, and is ready to be integrated. Choose the appropriate merge strategy based on your team\'s workflow and repository history preferences.',
    inputSchema: {
      type: 'object',
      properties: {
        project: { type: 'string', description: 'Bitbucket project key. If omitted, uses BITBUCKET_DEFAULT_PROJECT environment variable.' },
        repository: { type: 'string', description: 'Repository slug containing the pull request.' },
        prId: { type: 'number', description: 'Pull request ID to merge.' },
        message: { type: 'string', description: 'Custom merge commit message. If not provided, uses default merge message format.' },
        strategy: {
          type: 'string',
          enum: ['merge-commit', 'squash', 'fast-forward'],
          description: 'Merge strategy: "merge-commit" creates a merge commit preserving branch history, "squash" combines all commits into one, "fast-forward" moves the branch pointer without creating a merge commit.'
        }
      },
      required: ['repository', 'prId']
    }
  },

• src/index.ts:226-240 (schema)

  Input schema definition for the merge_pull_request tool, specifying parameters like project, repository, prId, message, and strategy.

  inputSchema: {
    type: 'object',
    properties: {
      project: { type: 'string', description: 'Bitbucket project key. If omitted, uses BITBUCKET_DEFAULT_PROJECT environment variable.' },
      repository: { type: 'string', description: 'Repository slug containing the pull request.' },
      prId: { type: 'number', description: 'Pull request ID to merge.' },
      message: { type: 'string', description: 'Custom merge commit message. If not provided, uses default merge message format.' },
      strategy: {
        type: 'string',
        enum: ['merge-commit', 'squash', 'fast-forward'],
        description: 'Merge strategy: "merge-commit" creates a merge commit preserving branch history, "squash" combines all commits into one, "fast-forward" moves the branch pointer without creating a merge commit.'
      }
    },
    required: ['repository', 'prId']
  }

• src/index.ts:459-469 (handler)

  Dispatch handler in the main CallToolRequestSchema switch statement that prepares parameters and calls the mergePullRequest method.

  case 'merge_pull_request': {
    const mergePrParams: PullRequestParams = {
      project: getProject(args.project as string),
      repository: args.repository as string,
      prId: args.prId as number
    };
    return await this.mergePullRequest(mergePrParams, {
      message: args.message as string,
      strategy: args.strategy as 'merge-commit' | 'squash' | 'fast-forward'
    });
  }