Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/api/pullrequests.ts:16-22 (handler)

  Core handler function in PullRequestsAPI that executes the Bitbucket API call to list pull requests for a repository.

  async list(params: ListPullRequestsParams): Promise<PaginatedResponse<BitbucketPullRequest>> {
    const { workspace, repo_slug, ...queryParams } = params;
    return this.client.get<PaginatedResponse<BitbucketPullRequest>>(
      `/repositories/${workspace}/${repo_slug}/pullrequests`,
      queryParams as Record<string, string | number | undefined>
    );
  }

• src/tools/index.ts:53-62 (schema)

  Zod schema defining input parameters and validation for the list_pull_requests tool.

  list_pull_requests: z.object({
    workspace: z.string().describe('The workspace slug'),
    repo_slug: z.string().describe('The repository slug'),
    state: z
      .enum(['OPEN', 'MERGED', 'DECLINED', 'SUPERSEDED'])
      .optional()
      .describe('Filter by state'),
    page: z.number().optional().describe('Page number'),
    pagelen: z.number().optional().describe('Results per page'),
  }),

• src/tools/index.ts:389-407 (registration)

  Tool registration in the toolDefinitions array, specifying name, description, and input schema for MCP.

  {
    name: 'list_pull_requests',
    description: 'List pull requests for a repository with optional filtering by state.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        workspace: { type: 'string', description: 'The workspace slug' },
        repo_slug: { type: 'string', description: 'The repository slug' },
        state: {
          type: 'string',
          enum: ['OPEN', 'MERGED', 'DECLINED', 'SUPERSEDED'],
          description: 'Filter by state',
        },
        page: { type: 'number', description: 'Page number' },
        pagelen: { type: 'number', description: 'Results per page' },
      },
      required: ['workspace', 'repo_slug'],
    },
  },

• src/types/index.ts:285-291 (schema)

  TypeScript interface defining the parameter types used by the handler.

  export interface ListPullRequestsParams {
    workspace: string;
    repo_slug: string;
    state?: 'OPEN' | 'MERGED' | 'DECLINED' | 'SUPERSEDED';
    page?: number;
    pagelen?: number;
  }

• src/tools/index.ts:927-930 (handler)

  Dispatch handler in ToolHandler.handleTool that parses arguments and calls the PullRequestsAPI.list method.

  case 'list_pull_requests': {
    const params = toolSchemas.list_pull_requests.parse(args);
    return this.prs.list(params);
  }