Bitbucket Cloud MCP Server

Instructions

Implementation Reference

• src/tools/index.ts:1030-1033 (handler)

  Handler logic for the 'get_issue' tool within ToolHandler.handleTool method. Parses arguments using the schema and calls IssuesAPI.get to fetch the issue.

  case 'get_issue': {
    const params = toolSchemas.get_issue.parse(args);
    return this.issues.get(params.workspace, params.repo_slug, params.issue_id);
  }

• src/tools/index.ts:208-212 (schema)

  Zod input schema definition for the 'get_issue' tool, specifying required parameters: workspace, repo_slug, and issue_id.

  get_issue: z.object({
    workspace: z.string().describe('The workspace slug'),
    repo_slug: z.string().describe('The repository slug'),
    issue_id: z.number().describe('The issue ID'),
  }),

• src/tools/index.ts:690-702 (registration)

  Registration of the 'get_issue' tool in the toolDefinitions array, including name, description, and input schema for MCP compatibility.

  {
    name: 'get_issue',
    description: 'Get details of a specific issue.',
    inputSchema: {
      type: 'object' as const,
      properties: {
        workspace: { type: 'string', description: 'The workspace slug' },
        repo_slug: { type: 'string', description: 'The repository slug' },
        issue_id: { type: 'number', description: 'The issue ID' },
      },
      required: ['workspace', 'repo_slug', 'issue_id'],
    },
  },

• src/api/issues.ts:26-30 (helper)

  IssuesAPI.get method, the supporting utility that performs the actual Bitbucket API GET request to retrieve the specific issue.

  async get(workspace: string, repo_slug: string, issue_id: number): Promise<BitbucketIssue> {
    return this.client.get<BitbucketIssue>(
      `/repositories/${workspace}/${repo_slug}/issues/${issue_id}`
    );
  }