# MCP Jira Server - Release Notes
## 🚀 Version 1.0.3 - January 27, 2026
### 🎯 Custom Fields & Security Updates
This release adds support for custom fields and addresses important security vulnerabilities.
### ✨ What's New
#### 🎨 **Custom Fields Support**
- **Create with Custom Fields**: Set custom field values when creating new issues
- **Update Custom Fields**: Modify custom field values in existing issues
- **Flexible Field Mapping**: Support for any custom field ID with proper value formatting
- **Type Safety**: Proper handling of different custom field types
#### 🔒 **Security Updates**
- **Updated axios** from 1.7.7 to 1.7.9 to address security vulnerabilities
- **Fixed follow-redirects** vulnerabilities in dependency tree
- All known security issues resolved
#### 🌐 **Reverse Proxy Support**
- **Custom User-Agent**: New `JIRA_USER_AGENT` environment variable
- **Proxy Compatibility**: Works with oauth2-proxy, nginx, and other reverse proxies
- **Header Whitelisting**: Support for API client filtering by User-Agent
### 📦 Package Information
- **npm Package**: `mcp-jira-server`
- **Version**: 1.0.3
- **License**: MIT
### 🔧 **Configuration**
#### New Environment Variable
```bash
JIRA_BASE_URL="https://your-jira-instance.com"
JIRA_PAT="your-personal-access-token"
JIRA_USER_AGENT="YourCustomUserAgent/1.0" # Optional
```
### 📋 **Updated Tools**
#### Enhanced Tools
- `jira_create_issue` - Now supports custom fields via optional parameters
- `jira_update_issue` - Can update custom field values
#### Example: Using Custom Fields
```typescript
// Create issue with custom fields
{
"projectKey": "PROJ",
"summary": "New feature",
"issueType": "Story",
"customfield_10001": "Custom value",
"customfield_10002": {"value": "Option 1"}
}
```
### 🔄 **Migration from 1.0.2**
No breaking changes! Simply update:
```bash
npm update mcp-jira-server
```
Or for npx users, it will automatically use the latest version:
```bash
npx mcp-jira-server
```
### 🙏 **Contributors**
Special thanks to:
- [@masoudsharifipour](https://github.com/masoudsharifipour) - Custom fields support
- [@eliasadvansys](https://github.com/eliasadvansys) - User-Agent header support
---
## 🚀 Version 1.0.2 - October 8, 2025
### 🎉 Initial Public Release
We're excited to announce the first public release of **MCP Jira Server** - A Model Context Protocol (MCP) server that brings powerful Jira integration to AI assistants like Claude Desktop and VS Code with GitHub Copilot.
### 📦 Package Information
- **npm Package**: `mcp-jira-server`
- **Version**: 1.0.2
- **License**: MIT
- **Bundle Size**: 11.4 kB compressed, 51.8 kB unpacked
### ✨ Key Features
#### 🔐 **Secure Authentication**
- **Personal Access Token (PAT)** authentication for self-hosted Jira instances
- Secure environment variable configuration
- No hardcoded credentials
#### 🛠️ **Complete Issue Management**
- **Create Issues**: Create new Jira issues with full metadata support
- **Read Issues**: Retrieve detailed issue information by key
- **Update Issues**: Modify existing issues (summary, description, assignee, priority, labels, status)
- **Delete Issues**: Permanently remove issues with proper permissions
- **Search Issues**: Powerful JQL (Jira Query Language) search capabilities
#### 💬 **Comment System**
- **Add Comments**: Post comments to any issue
- **Retrieve Comments**: Get all comments from an issue with full metadata
#### 👥 **User & Project Management**
- **Project Discovery**: List all available Jira projects
- **Project Details**: Get detailed information about specific projects
- **Issue Type Management**: Retrieve available issue types per project
- **User Assignment**: Assign issues to team members
- **Current User Info**: Get authenticated user details
#### 🔍 **Advanced Search**
- **JQL Support**: Full Jira Query Language support for complex searches
- **Flexible Results**: Configurable maximum results (default: 50)
- **Rich Metadata**: Complete issue data in search results
### 🚀 **Installation & Usage**
#### Quick Start
```bash
# Install and run immediately
npx mcp-jira-server
# Or install globally
npm install -g mcp-jira-server
mcp-jira-server
```
#### Integration Options
- **Claude Desktop**: Complete MCP server integration
- **VS Code**: GitHub Copilot extension support
- **Any MCP Client**: Standard Model Context Protocol compatibility
### 🔧 **Configuration**
#### Environment Variables
```bash
JIRA_BASE_URL="https://your-jira-instance.com"
JIRA_PAT="your-personal-access-token"
```
#### Claude Desktop Setup
```json
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["mcp-jira-server"],
"env": {
"JIRA_BASE_URL": "https://your-jira-instance.com",
"JIRA_PAT": "your-personal-access-token"
}
}
}
}
```
### 🛡️ **Robust Error Handling**
- **Graceful Startup**: Server starts even without configuration
- **Clear Error Messages**: Detailed feedback for missing credentials
- **API Error Handling**: Comprehensive Jira API error reporting
- **Configuration Validation**: Runtime validation of environment variables
### 📋 **Available Tools**
| Tool | Description | Required Parameters |
|------|-------------|-------------------|
| `jira_get_issue` | Get issue details by key | `issueKey` |
| `jira_search_issues` | Search issues using JQL | `jql`, `maxResults` (optional) |
| `jira_create_issue` | Create a new issue | `projectKey`, `summary`, `issueType` |
| `jira_update_issue` | Update existing issue | `issueKey` + update fields |
| `jira_add_comment` | Add comment to issue | `issueKey`, `comment` |
| `jira_get_comments` | Get all issue comments | `issueKey` |
| `jira_get_projects` | List all projects | None |
| `jira_get_project` | Get project details | `projectKey` |
| `jira_get_issue_types` | Get project issue types | `projectKey` |
| `jira_assign_issue` | Assign issue to user | `issueKey`, `assignee` |
| `jira_delete_issue` | Delete an issue | `issueKey` |
| `jira_get_current_user` | Get current user info | None |
### 🎯 **Use Cases**
#### For Development Teams
- **Sprint Planning**: Query backlog items and plan sprints with AI assistance
- **Bug Triaging**: Automatically categorize and assign bugs based on descriptions
- **Status Updates**: Get comprehensive project status reports
- **Documentation**: Generate reports from issue data
#### For Project Managers
- **Progress Tracking**: Monitor team progress across multiple projects
- **Resource Planning**: Analyze workload distribution
- **Reporting**: Create custom reports using JQL queries
- **Automation**: Automate routine issue management tasks
#### For QA Teams
- **Test Case Management**: Create and track test-related issues
- **Bug Reporting**: Streamlined bug creation with detailed information
- **Release Planning**: Track release-critical issues
### 🔄 **Integration Examples**
#### Natural Language Queries
```
"Show me all high-priority bugs assigned to John in the MOBILE project"
"Create a new story for user authentication in the WEB project"
"What are the current blockers for the next release?"
"Add a comment to PROJ-123 about the latest test results"
```
#### Automated Workflows
- **Daily Standups**: Get team's current work items
- **Release Planning**: Identify incomplete features
- **Bug Triage**: Categorize and prioritize new issues
- **Progress Reports**: Generate status summaries
### 🚦 **System Requirements**
- **Node.js**: 18.0.0 or higher
- **Jira**: Self-hosted instance with API access
- **Authentication**: Valid Personal Access Token
- **Network**: HTTPS access to Jira instance
### 🔗 **Links & Resources**
- **npm Package**: https://www.npmjs.com/package/mcp-jira-server
- **GitHub Repository**: https://github.com/edrich13/mcp-jira-server
- **Documentation**: See README.md for detailed setup instructions
- **Issue Tracker**: Report bugs and feature requests on GitHub
### 🙏 **Acknowledgments**
Built with the Model Context Protocol (MCP) SDK and designed for seamless integration with modern AI development workflows.
### 📝 **License**
MIT License - See LICENSE file for details
---
**Happy coding! 🎉**
*For support, questions, or feature requests, please visit our GitHub repository or contact the maintainer.*
