@thammarongg/jira-mcp 0.5.0 → 0.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thammarong G.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # jira-mcp
 
+[![npm version](https://img.shields.io/npm/v/@thammarongg/jira-mcp.svg)](https://www.npmjs.com/package/@thammarongg/jira-mcp)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![node](https://img.shields.io/node/v/@thammarongg/jira-mcp.svg)](https://nodejs.org)
+
 An [MCP](https://modelcontextprotocol.io) (Model Context Protocol) server that exposes the Jira REST API to AI assistants — boards, sprints, epics, issues, JQL search, workflow transitions, comments, worklogs, projects, users, plus a generic passthrough tool for **any** Jira REST endpoint.
 
 Works with both **Jira Cloud** (REST API v3) and **Jira Data Center** (REST API v2), auto-detected from the base URL.
@@ -11,7 +15,7 @@ Once published to npm, any MCP client can run it via `npx` — no local build ne
 ### Interactive installer (all agents at once)
 
 ```bash
-npx -y @thammarongg/jira-mcp install
+npx -y @thammarongg/jira-mcp@latest install
 ```
 
 Shows a menu — Select All or pick agents (Claude Code, OpenCode, Codex, Cursor,
@@ -29,12 +33,12 @@ Non-interactive (CI / scripting):
 
 ```bash
 # Jira Cloud
-npx -y @thammarongg/jira-mcp install --agents all \
+npx -y @thammarongg/jira-mcp@latest install --agents all \
   --base-url https://your-org.atlassian.net \
   --email you@example.com --token xxx --yes
 
 # Jira Data Center (subset of agents)
-npx -y @thammarongg/jira-mcp install --agents claude-code,codex \
+npx -y @thammarongg/jira-mcp@latest install --agents claude-code,codex \
   --base-url https://jira.yourcompany.com \
   --username you --token xxx --yes
 ```
@@ -47,12 +51,12 @@ Flags: `--agents all` or comma-separated ids/numbers (`claude-code`,
 ### CLI commands
 
 ```bash
-npx -y @thammarongg/jira-mcp update                 # refresh configured agents
-npx -y @thammarongg/jira-mcp update --agents codex
-npx -y @thammarongg/jira-mcp uninstall              # choose configured agents interactively
-npx -y @thammarongg/jira-mcp uninstall --agents all --yes
-npx -y @thammarongg/jira-mcp --version
-npx -y @thammarongg/jira-mcp --help
+npx -y @thammarongg/jira-mcp@latest update                 # refresh configured agents
+npx -y @thammarongg/jira-mcp@latest update --agents codex
+npx -y @thammarongg/jira-mcp@latest uninstall              # choose configured agents interactively
+npx -y @thammarongg/jira-mcp@latest uninstall --agents all --yes
+npx -y @thammarongg/jira-mcp@latest --version
+npx -y @thammarongg/jira-mcp@latest --help
 ```
 
 `update` is non-interactive and repairs every existing `jira` entry from that
@@ -61,7 +65,7 @@ removes only the `jira` entry, preserving the rest of each agent configuration;
 it accepts the same `--agents` selection grammar as `install` and asks for
 confirmation unless `--yes` is supplied.
 
-Running `npx -y @thammarongg/jira-mcp` bare in a terminal prints a status card
+Running `npx -y @thammarongg/jira-mcp@latest` bare in a terminal prints a status card
 with the installed version, configured agents, and available commands. MCP
 clients pipe stdio, so the same bare command starts the MCP server for them;
 it expects `JIRA_*` environment variables, which is why running it bare
@@ -72,7 +76,7 @@ without those variables reports a missing `JIRA_BASE_URL`.
 ```bash
 claude mcp add jira --env JIRA_BASE_URL=https://your-org.atlassian.net \
   --env JIRA_EMAIL=you@example.com --env JIRA_API_TOKEN=xxx \
-  -- npx -y @thammarongg/jira-mcp
+  -- npx -y @thammarongg/jira-mcp@latest
 ```
 
 ```json
@@ -81,7 +85,7 @@ claude mcp add jira --env JIRA_BASE_URL=https://your-org.atlassian.net \
   "mcpServers": {
     "jira": {
       "command": "npx",
-      "args": ["-y", "@thammarongg/jira-mcp"],
+      "args": ["-y", "@thammarongg/jira-mcp@latest"],
       "env": {
         "JIRA_BASE_URL": "https://your-org.atlassian.net",
         "JIRA_EMAIL": "you@example.com",
@@ -98,7 +102,7 @@ claude mcp add jira --env JIRA_BASE_URL=https://your-org.atlassian.net \
   "mcp": {
     "jira": {
       "type": "local",
-      "command": ["npx", "-y", "@thammarongg/jira-mcp"],
+      "command": ["npx", "-y", "@thammarongg/jira-mcp@latest"],
       "environment": {
         "JIRA_BASE_URL": "https://your-org.atlassian.net",
         "JIRA_EMAIL": "you@example.com",
@@ -284,3 +288,7 @@ node scripts/smoke.mjs   # stdio handshake + tools/list smoke test
 - Epics: the Agile epic API (`/rest/agile/1.0/epic/...`) only understands company-managed epics and returns HTTP 400 on team-managed ("next-gen") projects. `get_epic`, `get_epic_issues`, and `move_issue_to_epic` detect that and fall back to the issue/search APIs, where an epic is an ordinary issue linked to its children by `parent`.
 - Jira Data Center exposes platform REST API v2/latest, not `/rest/api/3`. Leave `JIRA_API_VERSION` at its default (`2`) for DC; forcing `3` against a DC host is unsupported and causes the server to request unavailable `/rest/api/3/...` routes. Cloud-vs-DC endpoint routing is based on the detected deployment (`*.atlassian.net` is Cloud), while field representations are based on the selected API version.
 - `jira_api` paths must resolve under `/rest/` — paths that would escape it (e.g. via `..` segments) are rejected, and `?`/`#` must be passed via `query`.
+
+## License
+
+[MIT](LICENSE) © Thammarong G.

package/dist/agents.js

@@ -22,6 +22,11 @@ export function readPackageVersion() {
     return typeof version === "string" && version.length > 0 ? version : "0.0.0";
 }
 export const PKG = readPackageName();
+// An unversioned npx package spec resolves the current project when the MCP
+// client starts in this repository, but this package's own bin is not linked
+// into node_modules/.bin. The explicit dist-tag forces npx to resolve the
+// published package in every working directory.
+export const PKG_SPEC = `${PKG}@latest`;
 export const PACKAGE_VERSION = readPackageVersion();
 export const claudeDesktopPath = platform() === "darwin"
     ? join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json")
@@ -296,7 +301,7 @@ function upsertCodex(path, env) {
     const block = [
         "[mcp_servers.jira]",
         'command = "npx"',
-        `args = ["-y", ${tomlStr(PKG)}]`,
+        `args = ["-y", ${tomlStr(PKG_SPEC)}]`,
         `env = { ${Object.entries(env)
             .map(([key, value]) => `${key} = ${tomlStr(value)}`)
             .join(", ")} }`,
@@ -358,7 +363,7 @@ export function writeAgentConfig(agent, env) {
             reportEnvChanges(envOf(mcp.jira), env, agent.path);
             mcp.jira = {
                 type: "local",
-                command: ["npx", "-y", PKG],
+                command: ["npx", "-y", PKG_SPEC],
                 environment: env,
                 enabled: true,
             };
@@ -367,7 +372,7 @@ export function writeAgentConfig(agent, env) {
     return mergeJsonFile(agent.path, (object) => {
         const mcpServers = (object.mcpServers ??= {});
         reportEnvChanges(envOf(mcpServers.jira), env, agent.path);
-        mcpServers.jira = { command: "npx", args: ["-y", PKG], env };
+        mcpServers.jira = { command: "npx", args: ["-y", PKG_SPEC], env };
     });
 }
 function removeJsonEntry(agent) {

package/dist/install.js

@@ -1,4 +1,4 @@
-import { AGENTS, PKG, readAgentEnv, resolveAgents, writeAgentConfig } from "./agents.js";
+import { AGENTS, PKG_SPEC, readAgentEnv, resolveAgents, writeAgentConfig } from "./agents.js";
 import { askPassword, makePrompter } from "./prompt.js";
 function parseFlags(argv) {
     const flags = {};
@@ -69,8 +69,8 @@ function printUsage() {
     console.log(`jira-mcp install — configure the jira MCP server in your agent(s)
 
 Usage:
-  npx -y ${PKG} install
-  npx -y ${PKG} install --agents all --base-url https://x.atlassian.net --email you@x.com --token xxx --yes
+  npx -y ${PKG_SPEC} install
+  npx -y ${PKG_SPEC} install --agents all --base-url https://x.atlassian.net --email you@x.com --token xxx --yes
 
 Options:
   --agents <list>    Comma-separated agent ids or 'all': ${AGENTS.map((a) => a.id).join(", ")}

package/dist/uninstall.js

@@ -1,4 +1,4 @@
-import { AGENTS, hasAgentEntry, removeAgentConfig, resolveAgents } from "./agents.js";
+import { AGENTS, PKG_SPEC, hasAgentEntry, removeAgentConfig, resolveAgents } from "./agents.js";
 import { makePrompter } from "./prompt.js";
 function parseFlags(argv) {
     const flags = {};
@@ -26,8 +26,8 @@ function printUsage() {
     console.log(`jira-mcp uninstall — remove jira MCP entries
 
 Usage:
-  npx -y @thammarongg/jira-mcp uninstall
-  npx -y @thammarongg/jira-mcp uninstall --agents all --yes
+  npx -y ${PKG_SPEC} uninstall
+  npx -y ${PKG_SPEC} uninstall --agents all --yes
 
 Options:
   --agents <list>    Comma-separated agent ids or 'all'

package/dist/update.js

@@ -1,4 +1,4 @@
-import { AGENTS, hasAgentEntry, readAgentEnv, resolveAgents, writeAgentConfig } from "./agents.js";
+import { AGENTS, PKG_SPEC, hasAgentEntry, readAgentEnv, resolveAgents, writeAgentConfig } from "./agents.js";
 function parseFlags(argv) {
     const flags = {};
     for (let i = 0; i < argv.length; i++) {
@@ -25,7 +25,7 @@ function printUsage() {
     console.log(`jira-mcp update — refresh existing jira MCP entries
 
 Usage:
-  npx -y @thammarongg/jira-mcp update [--agents <list>]
+  npx -y ${PKG_SPEC} update [--agents <list>]
 
 Options:
   --agents <list>    Comma-separated agent ids or 'all'

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@thammarongg/jira-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "MCP server exposing the Jira REST API (boards, sprints, issues, JQL, and a generic passthrough) for Jira Cloud and Data Center",
+  "homepage": "https://github.com/thammarongg/jira-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thammarongg/jira-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thammarongg/jira-mcp/issues"
+  },
+  "author": "Thammarong G. <thammrong@gmail.com>",
   "type": "module",
   "bin": {
     "jira-mcp": "dist/index.js"

package/skill/SKILL.md

@@ -19,10 +19,10 @@ Code, OpenCode, Codex, Cursor, Claude Desktop, Gemini CLI; backs up existing
 files to `.bak`):
 
 ```bash
-npx -y @thammarongg/jira-mcp install
+npx -y @thammarongg/jira-mcp@latest install
 ```
 
-Or non-interactive: `npx -y @thammarongg/jira-mcp install --agents all
+Or non-interactive: `npx -y @thammarongg/jira-mcp@latest install --agents all
 --base-url https://your-org.atlassian.net --email you@example.com --token xxx
 --yes`. Required env vars:
 
@@ -40,12 +40,12 @@ reuses those credentials without prompting.
 The CLI also supports these maintenance commands:
 
 ```bash
-npx -y @thammarongg/jira-mcp update                 # refresh configured entries
-npx -y @thammarongg/jira-mcp update --agents codex
-npx -y @thammarongg/jira-mcp uninstall              # choose entries to remove
-npx -y @thammarongg/jira-mcp uninstall --agents all --yes
-npx -y @thammarongg/jira-mcp --version
-npx -y @thammarongg/jira-mcp --help
+npx -y @thammarongg/jira-mcp@latest update                 # refresh configured entries
+npx -y @thammarongg/jira-mcp@latest update --agents codex
+npx -y @thammarongg/jira-mcp@latest uninstall              # choose entries to remove
+npx -y @thammarongg/jira-mcp@latest uninstall --agents all --yes
+npx -y @thammarongg/jira-mcp@latest --version
+npx -y @thammarongg/jira-mcp@latest --help
 ```
 
 `update` is non-interactive and skips agents without a `jira` entry.
@@ -61,7 +61,7 @@ Claude Code one-liner:
 ```bash
 claude mcp add jira --env JIRA_BASE_URL=https://your-org.atlassian.net \
   --env JIRA_EMAIL=you@example.com --env JIRA_API_TOKEN=xxx \
-  -- npx -y @thammarongg/jira-mcp
+  -- npx -y @thammarongg/jira-mcp@latest
 ```
 
 opencode (`opencode.json`):
@@ -71,7 +71,7 @@ opencode (`opencode.json`):
   "mcp": {
     "jira": {
       "type": "local",
-      "command": ["npx", "-y", "@thammarongg/jira-mcp"],
+      "command": ["npx", "-y", "@thammarongg/jira-mcp@latest"],
       "environment": {
         "JIRA_BASE_URL": "https://your-org.atlassian.net",
         "JIRA_EMAIL": "you@example.com",