open-index/open-npm huggingface dataset:
npm package: @moxxy/jira-mcp
Description: MCP server for JIRA Cloud. Lets AI agents read tickets, comments, attachments, and search issues via JQL.
Latest version: 1.0.2

# @moxxy/jira-mcp

MCP server for JIRA Cloud. Lets AI agents read tickets, comments, attachments, and search issues via JQL.

## Setup

```bash
npm install
```

### Option 1: Agent-managed configuration

Add to your `.mcp.json` (no credentials needed):

```json
{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/jira-mcp"
    }
  }
}
```

Then ask the agent to configure JIRA — it will use the `configure` tool to set up and persist credentials to `~/.jira-mcp/config.json`.

### Option 2: Environment variables

Pass credentials directly via env vars:

```json
{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/jira-mcp",
      "env": {
        "JIRA_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}
```

Env vars take priority over saved config.

### Getting a JIRA API token

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click **Create API token**
3. Copy the token

## Tools

| Tool | Description |
|------|-------------|
| `configure` | Set up or check JIRA connection. Persists credentials to `~/.jira-mcp/config.json` |
| `get_issue` | Get full issue details — description, status, assignee, subtasks, linked issues, attachments, custom fields |
| `get_comments` | Get comments on an issue (paginated, max 200) |
| `get_attachment` | Download an attachment — returns text content or base64 for images |
| `search_issues` | Search issues using JQL |
| `list_fields` | List available JIRA fields (useful for discovering custom field IDs) |

## Usage examples

```
"Investigate PD-12345"
"What are the open bugs in project PD?"
"Show me the comments on PD-12345"
"Read the screenshot.png attachment from PD-12345"
"What custom fields are available for story points?"
```