@jagadeesh52423/atlassian-mcp-server 1.1.0 → 1.1.2

package/README.md

@@ -3,33 +3,104 @@
 [![npm version](https://badge.fury.io/js/@jagadeesh52423%2Fatlassian-mcp-server.svg)](https://www.npmjs.com/package/@jagadeesh52423/atlassian-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A comprehensive Model Context Protocol (MCP) server that provides AI assistants with access to Atlassian APIs including Jira, Confluence, and Bitbucket.
+A comprehensive Model Context Protocol (MCP) server that provides AI assistants with access to Atlassian APIs including Jira, Confluence, and Bitbucket. **84 tools** across 3 services — the most complete Atlassian MCP server available.
+
+## Feature Comparison
+
+How we stack up against the official Atlassian MCP server and the popular sooperset/mcp-atlassian:
+
+### Confluence
+
+| Feature | Ours | Official Atlassian | sooperset |
+|---|:---:|:---:|:---:|
+| Search / Get / Create / Update page | YES | YES | YES |
+| Delete page | YES | NO | YES |
+| Get spaces / pages by space | YES | YES | NO |
+| Get child pages | YES | YES | YES |
+| Get/Add comments | YES | YES | YES |
+| **Update/Delete comment** | **YES** | NO | NO |
+| Get/Add/Delete attachments | YES | NO | YES |
+| **Embed image (with positioning)** | **YES** | NO | NO |
+| **Create page with inline images** | **YES** | NO | NO |
+| Get/Add/Remove labels | YES | NO | Partial |
+| **Page version history** | YES | NO | YES |
+
+### Jira
+
+| Feature | Ours | Official Atlassian | sooperset |
+|---|:---:|:---:|:---:|
+| Search/Get/Create/Update issue | YES | YES | YES |
+| Delete issue | YES | NO | YES |
+| Comments (full CRUD) | YES | Partial | Partial |
+| **Smart transition (AI auto-fill)** | **YES** | NO | NO |
+| Attachments (get/add/delete) | YES | NO | NO |
+| Issue links (full CRUD) | YES | NO | Partial |
+| Worklogs (full CRUD) | YES | Partial | Partial |
+| **Watchers (get/add/remove)** | **YES** | NO | NO |
+| **Subtasks (get/create)** | **YES** | NO | NO |
+| **Labels (get/add/remove)** | **YES** | NO | NO |
+| Agile boards & board issues | YES | NO | YES |
+| Sprints (list/create/update) | YES | NO | YES |
+| Sprint issues | YES | NO | YES |
+| Batch create issues | YES | NO | YES |
+| Dev status (PRs/branches/commits) | YES | NO | YES |
+| Issue history | YES | NO | YES |
+| Fields discovery | YES | NO | YES |
+| User lookup by name/email | YES | YES | YES |
+| Issue type metadata | YES | YES | NO |
+| Version/release management | YES | NO | YES |
+| Epic linking | YES | NO | YES |
+
+### Bitbucket
+
+| Feature | Ours | Official Atlassian | sooperset |
+|---|:---:|:---:|:---:|
+| **Full Bitbucket support (16 tools)** | **YES** | NO | NO |
+
+### Key Differentiators
+
+- **Only MCP server covering all 3 Atlassian products** — Confluence + Jira + Bitbucket
+- **Deepest CRUD coverage** — update/delete on comments, worklogs, labels where competitors only do create/read
+- **Smart Field Handling** — AI-driven field suggestions during Jira transitions, unique to this server
+- **Image embedding** — Confluence image embedding with positioning control, unique to this server
+- **84 total tools** vs ~45 (Official) and ~58 (sooperset)
 
 ## Features
 
-### Confluence Integration (14 tools)
+### Confluence Integration (20 tools)
 - Search pages by text query
-- Get specific pages by ID
-- Create and update pages with content
+- Get, create, update, and delete pages
 - List spaces and pages within spaces
+- **Child Pages**: Get child pages of a parent page
+- **Page History**: View version history of a page
 - **Attachments**: Add, list, and delete attachments
 - **Comments**: Full CRUD operations on page comments
-- **Images**: Embed images in page content
+- **Labels**: Get, add, and remove labels on pages
+- **Images**: Embed images in page content with positioning control
 - Full support for Confluence storage format
 
-### Jira Integration (29 tools)
-- Search issues by text or JQL query
-- Get specific issues by key
-- Create and update issues with customizable fields
+### Jira Integration (48 tools)
+- Search issues by text, filters, or JQL query
+- Get, create, update, and delete issues
 - **Comments**: Full CRUD operations on issue comments
 - **Transitions**: Move issues between statuses with **Smart Field Handling**
 - **Attachments**: Add, list, and delete attachments
 - **Issue Links**: Create and manage links between issues
-- **Worklogs**: Track time spent on issues
+- **Worklogs**: Full CRUD for time tracking entries
 - **Watchers**: Manage issue watchers
 - **Subtasks**: Create and list subtasks
 - **History**: View issue change history
-- List projects and issue types
+- **Labels**: Get, add, and remove labels on issues
+- **Fields**: Discover available standard and custom fields
+- **Agile**: List boards, get board issues, manage sprints
+- **Sprints**: Create, update, list sprint issues
+- **Versions**: Get, create, and update project versions/releases
+- **Batch Operations**: Bulk create up to 50 issues at once
+- **Dev Status**: View linked PRs, branches, and commits
+- **User Lookup**: Search users by name or email
+- **Issue Types**: Get available issue types per project
+- **Epic Linking**: Link issues to epics (next-gen + classic)
+- List projects
 
 #### Smart Field Handling
 Advanced transition management with intelligent field suggestions:
@@ -38,12 +109,12 @@ Advanced transition management with intelligent field suggestions:
 - **Auto-Suggestions**: Provides context-aware suggestions with reasoning
 - **Enhanced Error Handling**: Returns detailed field information instead of cryptic errors
 
-### Bitbucket Integration (11 tools)
+### Bitbucket Integration (16 tools)
 - List and search repositories
-- Get repository details
-- Create new repositories
+- Get repository details and create new repositories
 - Manage branches and commits
 - **Pull Requests**: Create, list, and get PR details with diffs
+- **PR Comments**: Full CRUD with resolve/unresolve support
 - Issue tracking within repositories
 
 ## Installation
@@ -121,7 +192,7 @@ ATLASSIAN_API_TOKEN=your-api-token
 4. Copy the token to your `.env` file
 
 #### Bitbucket API Token
-1. Go to your Bitbucket settings → Personal access tokens
+1. Go to your Bitbucket settings > Personal access tokens
 2. Create a new API token with required scopes:
    - Repositories: Read, Write
    - Issues: Read, Write
@@ -216,34 +287,45 @@ Add the following to your Claude Desktop configuration file:
 
 ## Available Tools
 
-### Confluence Tools (14 tools)
+### Confluence Tools (20 tools)
 
 | Tool | Description |
 |------|-------------|
 | `confluence_search_pages` | Search pages by text query |
 | `confluence_get_page` | Get specific page by ID |
-| `confluence_create_page` | Create new page with content |
+| `confluence_create_page` | Create new page with content and optional inline images |
 | `confluence_update_page` | Update existing page |
+| `confluence_delete_page` | Delete a page |
 | `confluence_get_spaces` | List all spaces |
 | `confluence_get_pages_by_space` | Get pages from specific space |
+| `confluence_get_page_children` | Get child pages of a parent page |
+| `confluence_get_page_history` | Get page version history |
 | `confluence_get_attachments` | List attachments on a page |
 | `confluence_add_attachment` | Add attachment to a page |
 | `confluence_delete_attachment` | Delete attachment from a page |
-| `confluence_embed_image` | Embed image in page content |
+| `confluence_embed_image` | Embed image in page content with positioning |
 | `confluence_get_comments` | Get comments on a page |
 | `confluence_add_comment` | Add comment to a page |
 | `confluence_update_comment` | Update existing comment |
 | `confluence_delete_comment` | Delete comment from a page |
+| `confluence_get_labels` | Get labels on a page |
+| `confluence_add_labels` | Add labels to a page |
+| `confluence_remove_label` | Remove a label from a page |
 
-### Jira Tools (29 tools)
+### Jira Tools (48 tools)
 
 | Tool | Description |
 |------|-------------|
-| `jira_search_issues` | Search issues by text or JQL |
+| **Core** | |
+| `jira_search_issues` | Search issues by text, filters, or JQL |
 | `jira_get_issue` | Get specific issue by key |
-| `jira_create_issue` | Create new issue |
+| `jira_create_issue` | Create new issue with custom fields |
 | `jira_update_issue` | Update existing issue |
+| `jira_delete_issue` | Delete issue with optional subtask deletion |
 | `jira_get_projects` | List all projects |
+| `jira_get_issue_types` | Get available issue types for a project |
+| `jira_get_fields` | Discover available standard and custom fields |
+| `jira_lookup_user` | Look up users by name or email |
 | **Comments** | |
 | `jira_add_comment` | Add comment to issue |
 | `jira_get_comments` | Get comments on an issue |
@@ -251,7 +333,7 @@ Add the following to your Claude Desktop configuration file:
 | `jira_delete_comment` | Delete comment from issue |
 | **Transitions** | |
 | `jira_get_issue_transitions` | Get available transitions |
-| `jira_transition_issue` | Change issue status (basic) |
+| `jira_transition_issue` | Change issue status |
 | `jira_transition_issue_interactive` | Change status with smart field handling |
 | **Attachments** | |
 | `jira_get_attachments` | List attachments on an issue |
@@ -271,12 +353,33 @@ Add the following to your Claude Desktop configuration file:
 | `jira_get_watchers` | Get issue watchers |
 | `jira_add_watcher` | Add watcher to issue |
 | `jira_remove_watcher` | Remove watcher from issue |
-| **Subtasks & History** | |
+| **Subtasks** | |
 | `jira_get_subtasks` | Get subtasks of an issue |
 | `jira_create_subtask` | Create subtask for an issue |
+| **Labels** | |
+| `jira_get_labels` | Get available labels |
+| `jira_add_labels` | Add labels to an issue |
+| `jira_remove_labels` | Remove labels from an issue |
+| **History** | |
 | `jira_get_issue_history` | Get issue change history |
-
-### Bitbucket Tools (11 tools)
+| **Agile / Sprints** | |
+| `jira_get_agile_boards` | List agile boards with optional filters |
+| `jira_get_board_issues` | Get issues on a board |
+| `jira_get_sprints` | Get sprints for a board |
+| `jira_get_sprint_issues` | Get issues in a sprint |
+| `jira_create_sprint` | Create a new sprint |
+| `jira_update_sprint` | Update sprint (name, state, dates, goal) |
+| **Versions / Releases** | |
+| `jira_get_project_versions` | Get all versions for a project |
+| `jira_create_version` | Create a new version/release |
+| `jira_update_version` | Update version (release, archive, dates) |
+| **Batch & Dev** | |
+| `jira_batch_create_issues` | Bulk create up to 50 issues |
+| `jira_get_dev_status` | Get linked PRs, branches, commits |
+| **Epic** | |
+| `jira_link_to_epic` | Link an issue to an epic |
+
+### Bitbucket Tools (16 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -290,6 +393,12 @@ Add the following to your Claude Desktop configuration file:
 | `bitbucket_get_commits` | List commits |
 | `bitbucket_get_issues` | List repository issues |
 | `bitbucket_create_issue` | Create new issue |
+| `bitbucket_get_pr_comments` | Get PR comments |
+| `bitbucket_add_pr_comment` | Add comment to a PR |
+| `bitbucket_update_pr_comment` | Update PR comment |
+| `bitbucket_delete_pr_comment` | Delete PR comment |
+| `bitbucket_resolve_pr_comment` | Resolve a PR comment |
+| `bitbucket_unresolve_pr_comment` | Unresolve a PR comment |
 
 ## Example Usage with AI Assistant
 
@@ -308,6 +417,12 @@ AI: Uses jira_transition_issue_interactive which automatically:
 
 User: "What pull requests are open in my main repository?"
 AI: Uses bitbucket_get_pull_requests with your repository name
+
+User: "Create 10 issues for the sprint backlog"
+AI: Uses jira_batch_create_issues to create all at once
+
+User: "Show me the active sprint and its issues"
+AI: Uses jira_get_sprints then jira_get_sprint_issues
 ```
 
 ### Smart Field Handling Examples
@@ -329,16 +444,29 @@ Smart Suggestion: DB Script = "Yes" (New features typically need database change
 ### Project Structure
 ```
 src/
-├── index.ts              # Main MCP server
-├── types.ts              # TypeScript interfaces
-├── config.ts             # Configuration management
-├── confluence-client.ts  # Confluence API client
-├── jira-client.ts        # Jira API client
-├── bitbucket-client.ts   # Bitbucket API client
-└── services/
-    ├── confluence.ts     # Confluence API service
-    ├── jira.ts          # Jira API service (with smart field handling)
-    └── bitbucket.ts     # Bitbucket API service
+├── index.ts                # Main MCP server & tool routing
+├── types.ts                # TypeScript interfaces
+├── config.ts               # Configuration management
+├── constants.ts            # Application-wide constants
+├── error-handler.ts        # Structured error handling
+├── clients/
+│   ├── base-client.ts      # Base HTTP client
+│   ├── confluence-client.ts
+│   ├── jira-client.ts
+│   └── bitbucket-client.ts
+├── services/
+│   ├── confluence.ts       # Confluence API service
+│   ├── jira.ts             # Jira API service (with smart field handling)
+│   └── bitbucket.ts        # Bitbucket API service
+├── tools/
+│   ├── index.ts            # Tool aggregation
+│   ├── confluence-tools.ts # Confluence tool definitions
+│   ├── jira-tools.ts       # Jira tool definitions
+│   └── bitbucket-tools.ts  # Bitbucket tool definitions
+└── handlers/
+    ├── confluence-handlers.ts
+    ├── jira-handlers.ts
+    └── bitbucket-handlers.ts
 ```
 
 ### Building and Testing
@@ -369,6 +497,7 @@ The server includes comprehensive error handling:
 - Network connectivity issues
 - Invalid parameters
 - Resource not found errors
+- Actionable tips for common issues
 
 ## Rate Limiting
 
@@ -393,4 +522,4 @@ MIT License - see LICENSE file for details
 
 - **npm package**: [@jagadeesh52423/atlassian-mcp-server](https://www.npmjs.com/package/@jagadeesh52423/atlassian-mcp-server)
 - **Issues & Feature Requests**: [GitHub Issues](https://github.com/jagadeeshpulamarasetti/atlassian-mcp-server/issues)
-- **Source Code**: [GitHub Repository](https://github.com/jagadeeshpulamarasetti/atlassian-mcp-server)
+- **Source Code**: [GitHub Repository](https://github.com/jagadeeshpulamarasetti/atlassian-mcp-server)

package/dist/formatters/adf-formatter.d.ts

@@ -3,11 +3,24 @@
  * Handles conversion between plain text/markdown and ADF format used by Jira API v3
  */
 /**
- * Extracts plain text from ADF (Atlassian Document Format) body
+ * Extracts plain text from ADF (Atlassian Document Format) body.
+ * Follows sooperset's recursive '\n'-joining approach.
  */
 export declare function extractTextFromADF(body: any): string;
 /**
- * Formats wiki markup to cleaner text
+ * Formats wiki markup to cleaner markdown text.
+ *
+ * Handles (in order):
+ *  - {code} / {noformat} blocks  → fenced code (extracted as placeholders first
+ *    so their contents are never touched by later transforms)
+ *  - Wiki tables ||h||            → markdown tables (pre-pass)
+ *  - {quote}                      → > blockquote
+ *  - {note}/{warning}/{info}/{tip}→ labelled blockquote
+ *  - [text|url] / [~user] / [url] → markdown links / @mention / bare URL
+ *  - \\                           → newline
+ *  - # item / ## item             → 1. / nested ordered list (wiki list syntax)
+ *  - h1. … h6.                    → # … ###### (must come AFTER list conversion)
+ *  - ---- / {panel} / {color} / checkboxes  (existing)
  */
 export declare function formatWikiMarkup(text: string): string;
 /**
@@ -22,4 +35,19 @@ export declare function parseDescriptionToADF(description: string): any;
  * Convert description to wiki markup text format
  */
 export declare function parseDescriptionToWikiMarkup(description: string): string;
+/**
+ * Converts LLM-produced markdown to Confluence storage format (XHTML).
+ * If the input already looks like storage format it is returned unchanged.
+ *
+ * Supported elements:
+ *  - ATX headings (#–######)
+ *  - Fenced code blocks (``` lang … ```) → ac:structured-macro "code"
+ *  - Blockquotes (> …)
+ *  - Unordered lists (- / * / +)
+ *  - Ordered lists (1. …)
+ *  - Markdown tables
+ *  - Horizontal rules (---, ***, ___)
+ *  - Inline: **bold**, *italic*, ~~strike~~, `code`, [text](url)
+ */
+export declare function markdownToConfluenceStorage(markdown: string): string;
 //# sourceMappingURL=adf-formatter.d.ts.map

package/dist/formatters/adf-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adf-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/adf-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAqGpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,CAmHzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAgT9D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6FxE"}
+{"version":3,"file":"adf-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/adf-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmHH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAKpD;AAqDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqErD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,CAoHzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAsT9D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6HxE;AA0DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2HpE"}