mcp-jira-cloud 2.0.0 → 2.0.2

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/tezaswi7222/jira-mcp/main/assets/logo.png" alt="Jira MCP Logo" width="120" height="120">
+  <img src="https://cdn.jsdelivr.net/npm/mcp-jira-cloud@latest/assets/logo.svg" alt="Jira MCP Logo" width="120" height="120">
 </p>
 
 <h1 align="center">Jira MCP Server</h1>
@@ -48,6 +48,26 @@
 
 A **Model Context Protocol (MCP)** server that enables AI assistants like **GitHub Copilot** and **Claude** to interact with your Jira Cloud instance. Search issues, manage tickets, log work, and more — all through natural language conversation.
 
+## 🎯 Why Use This Package?
+
+| Without MCP | With Jira MCP |
+|-------------|---------------|
+| Switch between IDE and browser | Stay in your coding environment |
+| Manual copy-paste of issue details | AI fetches context automatically |
+| Learn JQL syntax | Natural language queries |
+| Click through Jira UI | Voice/text commands |
+| Context switching kills productivity | Seamless workflow integration |
+
+### Supported AI Assistants
+
+| Assistant | Status |
+|-----------|--------|
+| GitHub Copilot (VS Code) | ✅ Fully Supported |
+| Claude Desktop | ✅ Fully Supported |
+| Cursor | ✅ Fully Supported |
+| Windsurf | ✅ Fully Supported |
+| Any MCP-compatible client | ✅ Fully Supported |
+
 ## ✨ Features
 
 <table>
@@ -63,9 +83,27 @@ A **Model Context Protocol (MCP)** server that enables AI assistants like **GitH
 <td>
 
 ### 📋 Issue Management
+- Full CRUD operations
+- Workflow transitions
 - Search with JQL
-- Get issue details & comments
-- View your open tickets
+
+</td>
+</tr>
+<tr>
+<td>
+
+### 🏃 Agile/Scrum
+- Sprint management (create, start, complete)
+- Board views (Scrum & Kanban)
+- Backlog & ranking
+
+</td>
+<td>
+
+### 🔗 Relationships
+- Issue linking (blocks, relates, duplicates)
+- Watchers & voting
+- Epic management
 
 </td>
 </tr>
@@ -80,15 +118,19 @@ A **Model Context Protocol (MCP)** server that enables AI assistants like **GitH
 </td>
 <td>
 
-### 💬 Collaboration
-- Add comments to issues
-- Access project information
-- List accessible projects
+### 🗄️ Filters & Metadata
+- Create/manage saved filters
+- Field metadata access
+- Component & version management
 
 </td>
 </tr>
 </table>
 
+<p align="center">
+  <strong>57 Tools</strong> for comprehensive Jira management
+</p>
+
 ## 🚀 Quick Start
 
 ### Installation
@@ -248,27 +290,32 @@ For OAuth authentication:
 
 ## 🛠️ Available Tools
 
-### Authentication
+> **57 tools** organised into 10 categories
+
+### 🔐 Authentication (7 tools)
 
 | Tool | Description |
 |------|-------------|
 | `jira_auth_status` | Check current authentication status |
 | `jira_whoami` | Get current user's Jira profile |
 | `jira_clear_auth` | Clear stored credentials |
-
-<details>
-<summary><strong>OAuth Tools</strong></summary>
-
-| Tool | Description |
-|------|-------------|
 | `jira_oauth_get_auth_url` | Generate OAuth authorisation URL |
 | `jira_oauth_exchange_code` | Exchange OAuth code for tokens |
 | `jira_oauth_refresh` | Manually refresh OAuth token |
 | `jira_oauth_list_sites` | List accessible Jira sites |
 
-</details>
+### 📝 Issue CRUD (6 tools)
 
-### Issue Management
+| Tool | Description |
+|------|-------------|
+| `jira_create_issue` | Create a new issue with full field support |
+| `jira_update_issue` | Update issue fields (partial update supported) |
+| `jira_delete_issue` | Delete an issue (with safety confirmation) |
+| `jira_assign_issue` | Assign or unassign a user |
+| `jira_get_transitions` | Get available workflow transitions |
+| `jira_transition_issue` | Move issue through workflow states |
+
+### 🔍 Issue Query (6 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -279,7 +326,7 @@ For OAuth authentication:
 | `jira_get_my_open_issues` | Get your open/in-progress issues |
 | `jira_resolve` | Smart routing tool for common intents |
 
-### Comments & Work Logs
+### 💬 Comments & Work Logs (4 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -288,12 +335,108 @@ For OAuth authentication:
 | `jira_add_worklog` | Log time spent on an issue |
 | `jira_get_worklogs` | Get work logs for an issue |
 
-### Projects
+### ⚙️ Configuration & Metadata (9 tools)
 
 | Tool | Description |
 |------|-------------|
 | `jira_list_projects` | List accessible Jira projects |
 | `jira_get_project` | Get project details and metadata |
+| `jira_get_issue_types` | Get available issue types |
+| `jira_get_priorities` | Get priority levels |
+| `jira_get_statuses` | Get available statuses |
+| `jira_get_components` | Get project components |
+| `jira_get_versions` | Get project versions |
+| `jira_search_users` | Search for Jira users |
+| `jira_get_changelog` | Get issue change history |
+
+<details>
+<summary><strong>🏃 Agile/Sprint Tools (16 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_boards` | List Scrum and Kanban boards |
+| `jira_get_board` | Get board details |
+| `jira_get_board_configuration` | Get board configuration (columns, estimation) |
+| `jira_get_sprints` | Get sprints for a board |
+| `jira_get_sprint` | Get sprint details |
+| `jira_create_sprint` | Create a new sprint |
+| `jira_update_sprint` | Update sprint details |
+| `jira_start_sprint` | Start a future sprint |
+| `jira_complete_sprint` | Complete an active sprint |
+| `jira_delete_sprint` | Delete a sprint |
+| `jira_get_sprint_issues` | Get issues in a sprint |
+| `jira_move_issues_to_sprint` | Move issues to a sprint |
+| `jira_get_backlog_issues` | Get backlog issues for a board |
+| `jira_move_issues_to_backlog` | Move issues to backlog |
+| `jira_rank_issues` | Change issue ranking |
+
+</details>
+
+<details>
+<summary><strong>🔗 Issue Relationships (11 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_issue_links` | Get linked issues |
+| `jira_create_issue_link` | Link two issues together |
+| `jira_delete_issue_link` | Remove an issue link |
+| `jira_get_link_types` | Get available link types |
+| `jira_get_watchers` | Get issue watchers |
+| `jira_add_watcher` | Add a watcher to an issue |
+| `jira_remove_watcher` | Remove a watcher |
+| `jira_get_votes` | Get issue vote count |
+| `jira_add_vote` | Vote for an issue |
+| `jira_remove_vote` | Remove your vote |
+
+</details>
+
+<details>
+<summary><strong>📎 Attachments (2 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_attachments` | Get issue attachments |
+| `jira_delete_attachment` | Delete an attachment |
+
+</details>
+
+<details>
+<summary><strong>📊 Epic Management (4 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_epics` | Get epics for a board |
+| `jira_get_epic_issues` | Get issues belonging to an epic |
+| `jira_move_issues_to_epic` | Move issues to an epic |
+| `jira_remove_issues_from_epic` | Remove issues from an epic |
+
+</details>
+
+<details>
+<summary><strong>🗂️ Field Metadata (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_fields` | Get all available fields (including custom) |
+| `jira_get_create_metadata` | Get metadata for creating issues |
+| `jira_get_edit_metadata` | Get metadata for editing issues |
+
+</details>
+
+<details>
+<summary><strong>🗄️ Filters (7 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `jira_get_filters` | Search saved filters |
+| `jira_get_filter` | Get filter details |
+| `jira_create_filter` | Create a new saved filter |
+| `jira_update_filter` | Update an existing filter |
+| `jira_delete_filter` | Delete a filter |
+| `jira_get_my_filters` | Get filters owned by you |
+| `jira_get_favourite_filters` | Get favourite filters |
+
+</details>
 
 ## 💡 Usage Examples
 
@@ -305,11 +448,27 @@ Once configured, interact with Jira through natural conversation:
 👤 "What's the status of PROJ-123?"
 🤖 Fetches and displays issue details, status, and assignee
 
-👤 "Find all open bugs assigned to me"
-🤖 Searches using JQL and returns matching issues
+👤 "Create a bug in PROJ for 'Login button not working'"
+🤖 Creates a new bug issue and returns the issue key
+
+👤 "Assign PROJ-456 to john@example.com"
+🤖 Assigns the issue to the specified user
+
+👤 "Move PROJ-789 to 'In Progress'"
+🤖 Transitions the issue to the new status
+```
+
+### Sprint & Agile
 
-👤 "What tickets am I working on?"
-🤖 Lists your in-progress issues
+```
+👤 "Show me the active sprint for board 123"
+🤖 Displays current sprint details with dates and goal
+
+👤 "Move PROJ-123 and PROJ-124 to sprint 456"
+🤖 Moves the issues to the specified sprint
+
+👤 "What's in the backlog for the PROJ board?"
+🤖 Lists all backlog issues with priorities
 ```
 
 ### Time Tracking
@@ -325,11 +484,14 @@ Once configured, interact with Jira through natural conversation:
 ### Collaboration
 
 ```
-👤 "Add a comment to PROJ-123 saying 'Fixed in latest commit'"
-🤖 Adds the comment to the issue
+👤 "Link PROJ-123 as blocking PROJ-456"
+🤖 Creates a "blocks" relationship between issues
+
+👤 "Add me as a watcher on PROJ-789"
+🤖 Adds you to the issue's watch list
 
-👤 "Show me the comments on PROJ-456"
-🤖 Displays all comments with authors and timestamps
+👤 "Show all issues in epic PROJ-100"
+🤖 Lists all child issues of the epic
 ```
 
 ## 🔧 Troubleshooting
@@ -390,10 +552,12 @@ The issue or project doesn't exist, or you don't have access to view it.
 | Attribute | Value |
 |-----------|-------|
 | Package name | [`mcp-jira-cloud`](https://www.npmjs.com/package/mcp-jira-cloud) |
+| Version | **2.0.0** |
 | License | [MIT](LICENSE) |
 | Node.js | ≥18.0.0 |
 | TypeScript | ≥5.0.0 |
 | Module | ES Modules |
+| Tools | **57** |
 
 ### Dependencies
 
@@ -404,6 +568,28 @@ The issue or project doesn't exist, or you don't have access to view it.
 | [`keytar`](https://www.npmjs.com/package/keytar) | Secure credential storage |
 | [`zod`](https://www.npmjs.com/package/zod) | Schema validation |
 
+## 🆕 What's New in v2.0.0
+
+<details>
+<summary><strong>Click to see full changelog</strong></summary>
+
+### Added
+- **Issue CRUD** - Create, update, delete issues with full field support
+- **Workflow Transitions** - Move issues through workflow states
+- **Agile/Scrum** - Complete sprint and board management (16 tools)
+- **Issue Linking** - Blocks, relates, duplicates relationships
+- **Watchers & Voting** - Collaboration features
+- **Epic Management** - Organise issues under epics
+- **Filters** - Create and manage saved JQL filters
+- **Metadata** - Access field configurations and create metadata
+
+### Changed
+- Total tools increased from 18 to 57
+- Improved TypeScript strict mode compliance
+- Enhanced error handling and validation
+
+</details>
+
 ## 🔒 Security
 
 - Credentials are stored securely via system keychain (Keytar)

package/assets/logo.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0052CC;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#2684FF;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="accentGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#FF5630;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#FF7452;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  
+  <!-- Background circle -->
+  <circle cx="60" cy="60" r="56" fill="url(#bgGrad)" />
+  
+  <!-- Jira-inspired shape -->
+  <g transform="translate(30, 28)">
+    <!-- Main shape -->
+    <path d="M30 0 L60 30 L30 60 L0 30 Z" fill="white" opacity="0.95"/>
+    
+    <!-- Inner diamond -->
+    <path d="M30 12 L48 30 L30 48 L12 30 Z" fill="url(#accentGrad)"/>
+    
+    <!-- Center dot -->
+    <circle cx="30" cy="30" r="6" fill="white"/>
+  </g>
+  
+  <!-- MCP text indicator -->
+  <text x="60" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="white">MCP</text>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-jira-cloud",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "A Model Context Protocol (MCP) server for Jira Cloud integration. Enables AI assistants like GitHub Copilot and Claude to search issues, manage tickets, log work, handle sprints, and interact with your Jira instance seamlessly. Features 57 tools for comprehensive Jira management.",
   "type": "module",
   "main": "dist/index.js",
@@ -15,10 +15,12 @@
     "./package.json": "./package.json"
   },
   "bin": {
+    "mcp-jira-cloud": "dist/index.js",
     "jira-mcp": "dist/index.js"
   },
   "files": [
     "dist",
+    "assets",
     "README.md",
     "CHANGELOG.md",
     "LICENSE",
@@ -56,7 +58,21 @@
     "ai",
     "llm",
     "developer-tools",
-    "productivity"
+    "productivity",
+    "agile",
+    "scrum",
+    "sprint",
+    "kanban",
+    "issue-tracker",
+    "project-management",
+    "cursor",
+    "windsurf",
+    "anthropic",
+    "openai",
+    "jira-api",
+    "rest-api",
+    "workflow",
+    "tickets"
   ],
   "author": {
     "name": "Tezaswi Raj (github: tezaswi7222)",