mcp-bitbucket-server 1.7.0 → 1.8.0

package/CLAUDE.md

@@ -8,21 +8,22 @@ This is an MCP (Model Context Protocol) server for Bitbucket Server/Data Center
 - **User management**: Get user profile, list all users
 - **Project operations**: List projects with filtering
 - **Repository operations**: List repositories in a project
-- **Pull request operations**: Get PR details, get inbox PRs, get changed files, get full/file diffs (text and structured), add comments (three separate tools: general, file-level, and line-level), delete comments, add/remove emoticon reactions, get activities, update review status (approve/request changes)
+- **Pull request operations**: Create PR, get PR details, get inbox PRs, get changed files, get full/file diffs (text and structured), add comments (three separate tools: general, file-level, and line-level), delete comments, add/remove emoticon reactions, get activities, update review status (approve/request changes)
 
 ## Architecture
 
-This is a **simple, straightforward implementation** with minimal abstraction:
+This is a **simple, straightforward implementation** using the `bitbucket-data-center-client` library:
 
 ```
-Tool → bitbucketClient (axios) → Bitbucket Server REST API
+Tool → bitbucketService (BitbucketClient) → Bitbucket Server REST API
 ```
 
 **Key principles:**
-- Direct axios client usage (no wrapper classes)
+- Use the `bitbucket-data-center-client` library for all API calls
+- Type-safe client methods (no manual endpoint construction)
 - Minimal error handling (let errors bubble up)
 - Simple, readable code
-- Verify all endpoints against Swagger documentation
+- Verify endpoint capabilities against Swagger documentation when needed
 
 ## Bitbucket Server API Documentation
 
@@ -40,23 +41,15 @@ grep -n '"/api/latest/users"' BitbucketServerSwagger.json
 # Use the line number from grep, then read ~80 lines
 ```
 
-### API Base URL
-
-All endpoints use: `${BITBUCKET_URL}/rest/api/latest`
-
-Example: `https://your-bitbucket-server.com/rest/api/latest/users`
-
 ### Authentication
 
-Uses **Bearer token** authentication:
+The `bitbucket-data-center-client` library handles authentication automatically using Bearer tokens.
 
-```typescript
-headers: {
-  Authorization: `Bearer ${token}`
-}
-```
+Configuration is done via environment variables in `.env`:
+- `BITBUCKET_URL`: Your Bitbucket Server base URL
+- `BITBUCKET_TOKEN`: Personal Access Token from Bitbucket Server
 
-The token is a Bitbucket Personal Access Token configured in `.env`.
+The library automatically adds the `Authorization: Bearer ${token}` header to all requests.
 
 ## Project Structure
 
@@ -65,134 +58,71 @@ src/
 ├── config.ts                    # Environment validation (BITBUCKET_URL, BITBUCKET_TOKEN)
 ├── index.ts                     # Main entry point, MCP server setup
 ├── services/
-│   └── bitbucket.ts            # Axios client instance (export const bitbucketClient)
-├── types/
-│   ├── index.ts                # Barrel export for all types
-│   ├── common.ts               # Shared types (PaginatedResponse)
-│   ├── pull-request.ts         # Pull request types (RestComment, RestPullRequest, etc.)
-│   └── repository.ts           # Repository-specific types
+│   └── bitbucket.ts            # BitbucketClient singleton (export const bitbucketService)
 └── tools/
     ├── index.ts                # Tool registration
     ├── users/
     │   ├── index.ts            # Barrel export
-    │   ├── get_user_profile.ts # GET /users/{username}
-    │   └── get_all_users.ts    # GET /users
+    │   ├── get_user_profile.ts # User profile operations
+    │   └── get_all_users.ts    # List all users
     ├── projects/
     │   ├── index.ts            # Barrel export
-    │   └── list_projects.ts    # GET /projects
+    │   └── list_projects.ts    # List projects with filtering
     ├── repositories/
     │   ├── index.ts            # Barrel export
-    │   └── list_repositories.ts # GET /projects/{projectKey}/repos
+    │   └── list_repositories.ts # List repositories in a project
     └── pull-requests/
-        ├── index.ts                    # Barrel export
-        ├── get_inbox_pull_requests.ts  # GET /inbox/pull-requests
-        ├── add_pr_comment.ts           # POST /projects/.../pull-requests/.../comments
-        ├── get_pr_changes.ts           # GET /projects/.../pull-requests/.../changes
-        ├── get_pr_file_diff.ts         # GET /projects/.../pull-requests/.../diff/{path}
-        ├── get_pr_activities.ts        # GET /projects/.../pull-requests/.../activities
-        └── update_review_status.ts     # PUT /projects/.../pull-requests/.../participants/{userSlug}
+        ├── index.ts                       # Barrel export
+        ├── get_inbox_pull_requests.ts     # Get PRs in reviewer's inbox
+        ├── get_pr_details.ts              # Get full PR details
+        ├── get_pr_diff.ts                 # Get PR diff (text or JSON)
+        ├── add_pr_comment.ts              # Add general/reply comment
+        ├── add_pr_file_comment.ts         # Add file-level comment
+        ├── add_pr_line_comment.ts         # Add line-specific comment
+        ├── delete_pr_comment.ts           # Delete comment
+        ├── add_pr_comment_reaction.ts     # Add emoticon reaction
+        ├── remove_pr_comment_reaction.ts  # Remove emoticon reaction
+        ├── get_pr_changes.ts              # Get changed files list
+        ├── get_pr_file_diff.ts            # Get structured file diff
+        ├── get_pr_activities.ts           # Get PR activities/comments
+        └── update_review_status.ts        # Approve/request changes
 ```
 
 ## TypeScript Types
 
-TypeScript type definitions for Bitbucket Server API responses are located in `src/types/`:
-
-```
-src/types/
-├── index.ts         # Barrel export (import from here)
-├── common.ts        # Shared types (PaginatedResponse)
-├── pull-request.ts  # Pull request types (RestComment, RestPullRequest, RestPullRequestParticipant, etc.)
-└── repository.ts    # Repository-specific types
-```
-
-### Type Naming Conventions
-
-- **Match Swagger schema names exactly**: `RestRepository`, `RestProject`, `RestPullRequest`
-- **Use interfaces for objects**: `interface RestRepository { ... }`
-- **Use union types for enums**: `type RepositoryState = "AVAILABLE" | "OFFLINE"`
-- **Generic wrapper types**: `PaginatedResponse<T>` for paginated endpoints
-- **Response type aliases**: `RepositoriesResponse = PaginatedResponse<RestRepository>`
-
-### Adding New Types
-
-1. **Find the schema in Swagger**:
-   ```bash
-   grep -n '"RestTypeName"' BitbucketServerSwagger.json
-   ```
-
-2. **Create/update type file** (e.g., `src/types/domain.ts`):
-   ```typescript
-   // Focus on readonly properties (what API returns)
-   export interface RestTypeName {
-     id: number;
-     name: string;
-     // ... other fields
-   }
-
-   export type DomainResponse = PaginatedResponse<RestTypeName>;
-   ```
-
-3. **Export from barrel file** (`src/types/index.ts`):
-   ```typescript
-   export type { RestTypeName, DomainResponse } from "./domain.js";
-   ```
-
-4. **Use in tool**:
-   ```typescript
-   import type { DomainResponse } from "../../types/index.js";
-
-   const response = await bitbucketClient.get<DomainResponse>("/endpoint");
-   ```
-
-### Type Design Principles
-
-Following the project's simplicity philosophy:
-
-**✅ DO:**
-- Map types directly from Swagger schemas
-- Focus on readonly properties (API responses)
-- Keep types simple and minimal
-- Use generic `PaginatedResponse<T>` for all paginated endpoints
-
-**❌ DON'T:**
-- Over-engineer with complex utility types
-- Include writeOnly properties (used for requests)
-- Add properties that aren't useful
-- Create unnecessary type abstractions
-
-## Tool Development Workflow
+All TypeScript types are provided by the `bitbucket-data-center-client` library. You don't need to define or maintain types manually.
 
-### 1. Find the Endpoint in Swagger
+The library exports comprehensive types for:
+- Users, projects, repositories
+- Pull requests, comments, activities
+- Diffs, changes, and review statuses
+- Paginated responses
 
-```bash
-# Search for the endpoint
-grep -n '"/api/latest/your-endpoint"' BitbucketServerSwagger.json
+Simply import types from the library when needed:
 
-# Read the specification
-# Note the line number, then read from that line
+```typescript
+import type { RestPullRequest, RestComment } from 'bitbucket-data-center-client';
 ```
 
-### 2. Verify Parameters
+## Tool Development Workflow
 
-**Check what parameters are actually supported:**
-- Path parameters (required in the URL)
-- Query parameters (optional filters, pagination)
-- Request body (for POST/PUT)
+### 1. Check the Library Documentation
 
-**Don't assume parameters exist** - the Swagger spec is the source of truth.
+The `bitbucket-data-center-client` library provides all necessary methods. Check:
+- Library README: https://github.com/evrimalacan/bitbucket-data-center-client
+- Existing tools in `src/tools/` for examples
 
-### 3. Implement the Tool
+### 2. Implement the Tool
 
-Follow this simple pattern:
+Follow this simple pattern using the client library:
 
 ```typescript
 import { z } from "zod";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { bitbucketClient } from "../../services/bitbucket.js";
-import type { YourResponseType } from "../../types/index.js";
+import { bitbucketService } from "../../services/bitbucket.js";
 
 const schema = z.object({
-  requiredParam: z.string().describe("Description from Swagger"),
+  requiredParam: z.string().describe("Description of parameter"),
   optionalParam: z.string().optional().describe("Optional parameter"),
 });
 
@@ -201,21 +131,21 @@ export const toolNameTool = (server: McpServer) => {
     "bitbucket_tool_name",
     {
       title: "Human Readable Title",
-      description: "Description from Swagger documentation",
+      description: "Clear description of what this tool does",
       inputSchema: schema.shape,
     },
-    async (params) => {
-      const { requiredParam, optionalParam } = schema.parse(params);
-
-      const response = await bitbucketClient.get<YourResponseType>("/endpoint", {
-        params: optionalParam ? { optionalParam } : {},
+    async ({ requiredParam, optionalParam }) => {
+      // Call the appropriate library method
+      const result = await bitbucketService.someMethod({
+        requiredParam,
+        optionalParam,
       });
 
       return {
         content: [
           {
             type: "text",
-            text: JSON.stringify(response.data, null, 2),
+            text: JSON.stringify(result, null, 2),
           },
         ],
       };
@@ -224,7 +154,7 @@ export const toolNameTool = (server: McpServer) => {
 };
 ```
 
-### 4. Register the Tool
+### 3. Register the Tool
 
 ```typescript
 // 1. Export from domain barrel file (e.g., src/tools/users/index.ts)
@@ -239,7 +169,7 @@ export function registerTools(server: McpServer) {
 }
 ```
 
-### 5. Run the Linter
+### 4. Run the Linter
 
 Always run the linter after implementing a new tool:
 
@@ -254,48 +184,51 @@ The linter will auto-fix formatting, catch unused variables, and ensure code qua
 ### Keep It Simple
 
 **✅ DO:**
-- Use direct axios calls: `bitbucketClient.get(...)`
-- Minimal error handling (only when necessary)
+- Use `bitbucketService` client methods: `bitbucketService.getUserProfile(...)`
+- Minimal error handling (let errors bubble up)
 - Short, focused functions
 - Clear parameter names
+- Destructure parameters directly in async handler
 
 **❌ DON'T:**
-- Add wrapper classes
+- Add wrapper functions around the library
 - Over-engineer error handling
 - Add unnecessary abstractions
-- Use try-catch unless required
+- Use try-catch unless absolutely required
 
 ### Example: Simple Tool
 
 ```typescript
-// ✅ Good - simple and direct
-export const getAllUsersTool = (server: McpServer) => {
-  server.registerTool("bitbucket_get_all_users", { ... }, async (params) => {
-    const { filter } = schema.parse(params);
-
-    const response = await bitbucketClient.get("/users", {
-      params: filter ? { filter } : {},
-    });
-
-    return {
-      content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }],
-    };
-  });
+// ✅ Good - simple and direct using the library
+export const getUserProfileTool = (server: McpServer) => {
+  server.registerTool(
+    "bitbucket_get_user_profile",
+    {
+      title: "Get Bitbucket User Profile",
+      description: "Gets Bitbucket Server user profile details by username",
+      inputSchema: schema.shape,
+    },
+    async ({ username }) => {
+      const user = await bitbucketService.getUserProfile({ username });
+
+      return {
+        content: [{ type: "text", text: JSON.stringify(user, null, 2) }],
+      };
+    }
+  );
 };
 ```
 
 ```typescript
 // ❌ Bad - over-engineered
-export const getAllUsersTool = (server: McpServer) => {
-  server.registerTool("bitbucket_get_all_users", { ... }, async (params) => {
+export const getUserProfileTool = (server: McpServer) => {
+  server.registerTool("bitbucket_get_user_profile", { ... }, async (params) => {
     try {
-      const { filter } = schema.parse(params);
-
-      const queryParams = buildQueryParams({ filter }); // Unnecessary
-      const client = getClient(); // Unnecessary wrapper
-      const response = await client.get("/users", queryParams);
+      const validated = validateParams(params); // Unnecessary - zod handles this
+      const client = getClient(); // Unnecessary - use bitbucketService directly
+      const response = await client.getUser(validated.username);
 
-      return handleResponse(response); // Over-abstracted
+      return formatResponse(response); // Over-abstracted
     } catch (error) {
       return handleError(error); // Let errors bubble
     }
@@ -364,6 +297,28 @@ export const getAllUsersTool = (server: McpServer) => {
 
 **Purpose**: Discover all PRs across all projects and repositories that need your review in one call. Much more efficient than querying project by project. Use the `id`, `projectKey`, and `repositorySlug` from the response to review specific PRs with other tools.
 
+### bitbucket_create_pull_request
+**File**: `src/tools/pull-requests/create_pull_request.ts`
+**Endpoint**: `POST /projects/{projectKey}/repos/{repositorySlug}/pull-requests`
+**Parameters**:
+- `projectKey` (required): The Bitbucket Server project key
+- `repositorySlug` (required): The repository slug
+- `fromBranch` (required): Source branch name (e.g., "feature-x")
+- `toBranch` (required): Target branch name (e.g., "main")
+- `title` (required): PR title
+- `description` (optional): PR description in markdown format
+- `reviewers` (optional): Array of reviewer usernames to add
+
+**Returns**: Created pull request object including `id`, `title`, `state`, `fromRef`, `toRef`, `author`, and web URL.
+
+**Purpose**: Create a new pull request from a source branch to a target branch. Accepts simple branch names - they are automatically converted to full refs (e.g., "main" → "refs/heads/main").
+
+**Error Cases**:
+- 400: Malformed request
+- 401: Insufficient permissions
+- 404: Repository or branches don't exist
+- 409: Branches are the same, PR already exists, or target repo is archived
+
 ### bitbucket_get_pull_request
 **File**: `src/tools/pull-requests/get_pr_details.ts`
 **Endpoint**: `GET /projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}`
@@ -568,7 +523,7 @@ export const getAllUsersTool = (server: McpServer) => {
 - `repositorySlug` (required): The repository slug
 - `pullRequestId` (required): The pull request ID
 - `commentId` (required): The comment ID
-- `emoticon` (required): The emoticon identifier - one of: `thumbsup`, `thumbsdown`, `heart`, `thinking_face`, `laugh`
+- `emoticon` (required): The emoticon identifier - one of: `thumbsup`, `thumbsdown`, `heart`, `thinking_face`, `laughing`
 
 **Returns**: RestUserReaction object with comment, emoticon details (shortcut, url), and user who reacted.
 
@@ -579,7 +534,7 @@ export const getAllUsersTool = (server: McpServer) => {
 - `thumbsdown` - Thumbs down 👎
 - `heart` - Heart ❤️
 - `thinking_face` - Thinking face 🤔
-- `laugh` - Laughing face 😄
+- `laughing` - Laughing face 😄
 
 **Note**: Uses the Bitbucket Server comment-likes plugin API (`/rest/comment-likes/latest/`), not the core API.
 
@@ -591,7 +546,7 @@ export const getAllUsersTool = (server: McpServer) => {
 - `repositorySlug` (required): The repository slug
 - `pullRequestId` (required): The pull request ID
 - `commentId` (required): The comment ID
-- `emoticon` (required): The emoticon identifier to remove - one of: `thumbsup`, `thumbsdown`, `heart`, `thinking_face`, `laugh`
+- `emoticon` (required): The emoticon identifier to remove - one of: `thumbsup`, `thumbsdown`, `heart`, `thinking_face`, `laughing`
 
 **Returns**: Simple success message (204 No Content).
 
@@ -709,42 +664,28 @@ See `.env.example` for template.
 
 ### Pagination
 
-Many endpoints support pagination:
+The `bitbucket-data-center-client` library handles pagination automatically. Just pass the pagination parameters:
 
 ```typescript
-const response = await bitbucketClient.get("/endpoint", {
-  params: {
-    start: 0,
-    limit: 25,
-  },
+const result = await bitbucketService.listProjects({
+  start: 0,
+  limit: 25,
 });
 ```
 
-Response includes:
+Paginated responses include:
 - `values`: Array of results
 - `size`: Number of results in this page
 - `limit`: Page size
 - `isLastPage`: Boolean
 - `nextPageStart`: Start value for next page
 
-### Error Responses
+### Error Handling
 
-Bitbucket Server returns errors in this format:
-
-```json
-{
-  "errors": [
-    {
-      "context": "field_name",
-      "message": "Error description",
-      "exceptionName": "ExceptionType"
-    }
-  ]
-}
-```
+The library throws errors with Bitbucket Server's error format. Let them bubble up - the MCP SDK will handle them appropriately.
 
 ## Resources
 
-- **Swagger Documentation**: `BitbucketServerSwagger.json` in project root
-- **Bitbucket Server REST API**: `${BITBUCKET_URL}/rest/api/latest/`
-- **OpenAPI Spec**: Available via Bitbucket Server UI (triple dot menu)
+- **Library Documentation**: https://github.com/evrimalacan/bitbucket-data-center-client
+- **Swagger Documentation**: `BitbucketServerSwagger.json` in project root (for reference)
+- **Bitbucket Server REST API Docs**: Available via Bitbucket Server UI (triple dot menu)

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-export * from './client/index.js';
+export * from 'bitbucket-data-center-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // ============ Library Exports ============
-// Re-export everything from client for library usage
-export * from './client/index.js';
+// Re-export the Bitbucket client library (use bitbucket-data-center-client directly for library usage)
+export * from 'bitbucket-data-center-client';
 // ============ MCP Server Setup ============
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,4CAA4C;AAC5C,qDAAqD;AACrD,cAAc,mBAAmB,CAAC;AAElC,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,cAAc;IAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,cAAc,EAAE,CAAC;AACzB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,4CAA4C;AAC5C,uGAAuG;AACvG,cAAc,8BAA8B,CAAC;AAE7C,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,cAAc;IAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,cAAc,EAAE,CAAC;AACzB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/services/bitbucket.d.ts

@@ -1,7 +1,7 @@
-import { BitbucketService } from '../client/bitbucket.client.js';
+import { BitbucketClient } from 'bitbucket-data-center-client';
 /**
- * Singleton BitbucketService instance for MCP tools.
+ * Singleton BitbucketClient instance for MCP tools.
  * Created from environment configuration.
  */
-export declare const bitbucketService: BitbucketService;
+export declare const bitbucketService: BitbucketClient;
 //# sourceMappingURL=bitbucket.d.ts.map

package/dist/services/bitbucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitbucket.d.ts","sourceRoot":"","sources":["../../src/services/bitbucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,kBAG3B,CAAC"}
+{"version":3,"file":"bitbucket.d.ts","sourceRoot":"","sources":["../../src/services/bitbucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iBAG3B,CAAC"}

package/dist/services/bitbucket.js

@@ -1,10 +1,10 @@
-import { BitbucketService } from '../client/bitbucket.client.js';
+import { BitbucketClient } from 'bitbucket-data-center-client';
 import { bitbucketConfig } from '../config.js';
 /**
- * Singleton BitbucketService instance for MCP tools.
+ * Singleton BitbucketClient instance for MCP tools.
  * Created from environment configuration.
  */
-export const bitbucketService = new BitbucketService({
+export const bitbucketService = new BitbucketClient({
     baseUrl: bitbucketConfig.baseUrl,
     token: bitbucketConfig.token,
 });

package/dist/services/bitbucket.js.map

@@ -1 +1 @@
-{"version":3,"file":"bitbucket.js","sourceRoot":"","sources":["../../src/services/bitbucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC;IACnD,OAAO,EAAE,eAAe,CAAC,OAAO;IAChC,KAAK,EAAE,eAAe,CAAC,KAAK;CAC7B,CAAC,CAAC"}
+{"version":3,"file":"bitbucket.js","sourceRoot":"","sources":["../../src/services/bitbucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,eAAe,CAAC;IAClD,OAAO,EAAE,eAAe,CAAC,OAAO;IAChC,KAAK,EAAE,eAAe,CAAC,KAAK;CAC7B,CAAC,CAAC"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QAyB9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QA0B9C"}

package/dist/tools/index.js

@@ -1,5 +1,5 @@
 import { listProjectsTool } from './projects/index.js';
-import { addPrCommentReactionTool, addPrCommentTool, addPrFileCommentTool, addPrLineCommentTool, deletePrCommentTool, getInboxPullRequestsTool, getPrActivitiesTool, getPrChangesTool, getPrFileDiffTool, getPullRequestDetailsTool, getPullRequestDiffTool, removePrCommentReactionTool, updateReviewStatusTool, } from './pull-requests/index.js';
+import { addPrCommentReactionTool, addPrCommentTool, addPrFileCommentTool, addPrLineCommentTool, createPullRequestTool, deletePrCommentTool, getInboxPullRequestsTool, getPrActivitiesTool, getPrChangesTool, getPrFileDiffTool, getPullRequestDetailsTool, getPullRequestDiffTool, removePrCommentReactionTool, updateReviewStatusTool, } from './pull-requests/index.js';
 import { listRepositoriesTool } from './repositories/index.js';
 import { getAllUsersTool, getUserProfileTool } from './users/index.js';
 export function registerTools(server) {
@@ -11,6 +11,7 @@ export function registerTools(server) {
     // Repository tools
     listRepositoriesTool(server);
     // Pull request tools
+    createPullRequestTool(server);
     getInboxPullRequestsTool(server);
     getPullRequestDetailsTool(server);
     addPrCommentTool(server);

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,aAAa;IACb,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,gBAAgB;IAChB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,mBAAmB;IACnB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,qBAAqB;IACrB,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,aAAa;IACb,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,gBAAgB;IAChB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,mBAAmB;IACnB,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,qBAAqB;IACrB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/pull-requests/add_pr_comment_reaction.js

@@ -6,13 +6,13 @@ const schema = z.object({
     pullRequestId: z.number().describe('The pull request ID'),
     commentId: z.number().describe('The comment ID'),
     emoticon: z
-        .enum(['thumbsup', 'thumbsdown', 'heart', 'thinking_face', 'laugh'])
-        .describe('The emoticon to add (thumbsup, thumbsdown, heart, thinking_face, laugh)'),
+        .enum(['thumbsup', 'thumbsdown', 'heart', 'thinking_face', 'laughing'])
+        .describe('The emoticon to add (thumbsup, thumbsdown, heart, thinking_face, laughing)'),
 });
 export const addPrCommentReactionTool = (server) => {
     server.registerTool('bitbucket_add_pr_comment_reaction', {
         title: 'Add Emoticon Reaction to PR Comment',
-        description: 'Add an emoticon reaction to a pull request comment. Supported emoticons: thumbsup, thumbsdown, heart, thinking_face, laugh. The operation is idempotent - adding the same reaction twice will succeed.',
+        description: 'Add an emoticon reaction to a pull request comment. Supported emoticons: thumbsup, thumbsdown, heart, thinking_face, laughing. The operation is idempotent - adding the same reaction twice will succeed.',
         inputSchema: schema.shape,
     }, async ({ projectKey, repositorySlug, pullRequestId, commentId, emoticon }) => {
         const result = await bitbucketService.addPullRequestCommentReaction({

package/dist/tools/pull-requests/add_pr_comment_reaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"add_pr_comment_reaction.js","sourceRoot":"","sources":["../../../src/tools/pull-requests/add_pr_comment_reaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;SACnE,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAiB,EAAE,EAAE;IAC5D,MAAM,CAAC,YAAY,CACjB,mCAAmC,EACnC;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,wMAAwM;QAC1M,WAAW,EAAE,MAAM,CAAC,KAAK;KAC1B,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,6BAA6B,CAAC;YAClE,UAAU;YACV,cAAc;YACd,aAAa;YACb,SAAS;YACT,QAAQ;SACT,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,MAAM,CAAC,QAAQ,CAAC,QAAQ,mCAAmC,SAAS,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG;iBACzH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"add_pr_comment_reaction.js","sourceRoot":"","sources":["../../../src/tools/pull-requests/add_pr_comment_reaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;SACtE,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAiB,EAAE,EAAE;IAC5D,MAAM,CAAC,YAAY,CACjB,mCAAmC,EACnC;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,2MAA2M;QAC7M,WAAW,EAAE,MAAM,CAAC,KAAK;KAC1B,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,6BAA6B,CAAC;YAClE,UAAU;YACV,cAAc;YACd,aAAa;YACb,SAAS;YACT,QAAQ;SACT,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,MAAM,CAAC,QAAQ,CAAC,QAAQ,mCAAmC,SAAS,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG;iBACzH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/tools/pull-requests/create_pull_request.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const createPullRequestTool: (server: McpServer) => void;
+//# sourceMappingURL=create_pull_request.d.ts.map

package/dist/tools/pull-requests/create_pull_request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_pull_request.d.ts","sourceRoot":"","sources":["../../../src/tools/pull-requests/create_pull_request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,SA8BtD,CAAC"}

package/dist/tools/pull-requests/create_pull_request.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { bitbucketService } from '../../services/bitbucket.js';
+const schema = z.object({
+    projectKey: z.string().describe('The Bitbucket project key'),
+    repositorySlug: z.string().describe('The repository slug'),
+    fromBranch: z.string().describe('Source branch name (e.g., "feature-x")'),
+    toBranch: z.string().describe('Target branch name (e.g., "main")'),
+    title: z.string().describe('PR title'),
+    description: z.string().optional().describe('PR description in markdown format'),
+    reviewers: z.array(z.string()).optional().describe('Array of reviewer usernames to add'),
+});
+export const createPullRequestTool = (server) => {
+    server.registerTool('bitbucket_create_pull_request', {
+        title: 'Create Pull Request',
+        description: 'Create a new pull request from a source branch to a target branch. Accepts simple branch names (e.g., "feature-x", "main") - they are automatically converted to full refs. Returns the created PR details including ID, title, state, and web URL.',
+        inputSchema: schema.shape,
+    }, async ({ projectKey, repositorySlug, fromBranch, toBranch, title, description, reviewers }) => {
+        const result = await bitbucketService.createPullRequest({
+            projectKey,
+            repositorySlug,
+            title,
+            description,
+            fromBranch,
+            toBranch,
+            reviewers,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+};
+//# sourceMappingURL=create_pull_request.js.map

package/dist/tools/pull-requests/create_pull_request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_pull_request.js","sourceRoot":"","sources":["../../../src/tools/pull-requests/create_pull_request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC5D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACzE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAChF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAiB,EAAE,EAAE;IACzD,MAAM,CAAC,YAAY,CACjB,+BAA+B,EAC/B;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,qPAAqP;QACvP,WAAW,EAAE,MAAM,CAAC,KAAK;KAC1B,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5F,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,iBAAiB,CAAC;YACtD,UAAU;YACV,cAAc;YACd,KAAK;YACL,WAAW;YACX,UAAU;YACV,QAAQ;YACR,SAAS;SACV,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}