@stubbedev/atlassian-mcp 0.1.15 → 0.1.17

package/README.md

@@ -273,10 +273,23 @@ This package is published to npm as `@stubbedev/atlassian-mcp`.
 
 Use semantic versioning for releases. Breaking tool-surface changes should bump the minor version while `<1.0.0` (for example `0.0.x` -> `0.1.0`).
 
-Automatic publish is configured in `.github/workflows/publish.yml`:
+Automatic publish is configured in `.github/workflows/publish.yml` and runs when a new version tag is pushed.
 
-- Push a tag like `v1.0.1` to publish from CI
-- Or run the workflow manually via **Actions → Publish Package**
+Release flow:
+
+```bash
+# choose one: patch | minor | major
+increment=patch
+
+# bumps package.json + package-lock.json,
+# creates a version commit, and creates a git tag (for example v0.1.17)
+npm version "$increment"
+
+# push commit and tag to GitHub
+git push origin HEAD --follow-tags
+```
+
+GitHub Actions will publish the npm release from that pushed tag.
 
 - The workflow is configured for npm Trusted Publisher (OIDC), so no `NPM_TOKEN` secret is required
 
@@ -284,13 +297,6 @@ Required npm setup (one-time):
 
 - In npm package settings, add this GitHub repo/workflow as a Trusted Publisher
 
-Manual publish from local machine:
-
-```bash
-npm run build
-npm publish --access public
-```
-
 ---
 
 ## Creating Personal Access Tokens

package/dist/index.js

@@ -39,6 +39,7 @@ function normalizeJiraMutateArgs(args) {
     }
     return out;
 }
+const JIRA_WIKI_MARKUP_HINT = 'Use Jira wiki markup (Atlassian renderer syntax), not GitHub/CommonMark markdown.';
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         // ── Context ───────────────────────────────────────────────────────────
@@ -157,7 +158,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'jira_create_issue',
-            description: 'Use when you want to create a new Jira ticket (bug, story, task, etc.). If projectKey/project is omitted, the server auto-picks from branch context or asks you to choose.',
+            description: `Use when you want to create a new Jira ticket (bug, story, task, etc.). If projectKey/project is omitted, the server auto-picks from branch context or asks you to choose. ${JIRA_WIKI_MARKUP_HINT}`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -165,7 +166,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     project: { type: 'string', description: 'Alias for projectKey' },
                     issueType: { type: 'string', description: 'Issue type name, for example "Bug", "Story", or "Task"' },
                     summary: { type: 'string', description: 'Issue title' },
-                    description: { type: 'string', description: 'Issue description (optional)' },
+                    description: { type: 'string', description: `Issue description (optional). ${JIRA_WIKI_MARKUP_HINT}` },
                     assignee: { type: 'string', description: 'Username to assign to (optional)' },
                     priority: { type: 'string', description: 'Priority name, e.g. "High" (optional)' },
                     sprintId: { type: 'number', description: 'Sprint ID to immediately add the new issue into (optional)' },
@@ -175,13 +176,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'jira_update_issue',
-            description: 'Use when you want to edit an existing Jira ticket: title, description, assignee, or priority.',
+            description: `Use when you want to edit an existing Jira ticket: title, description, assignee, or priority. ${JIRA_WIKI_MARKUP_HINT}`,
             inputSchema: {
                 type: 'object',
                 properties: {
                     issueKey: { type: 'string', description: 'Jira issue key' },
                     summary: { type: 'string', description: 'New summary (optional)' },
-                    description: { type: 'string', description: 'New description (optional)' },
+                    description: { type: 'string', description: `New description (optional). ${JIRA_WIKI_MARKUP_HINT}` },
                     assignee: { type: 'string', description: 'New assignee username, or empty string to unassign (optional)' },
                     priority: { type: 'string', description: 'New priority name (optional)' },
                     sprintId: { type: 'number', description: 'Sprint ID to add this issue into (optional)' },
@@ -204,7 +205,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'jira_mutate_issue',
-            description: 'Use when you want to bundle Jira mutations in one call: create or target an issue, then optional update, sprint assignment, transition, and comment.',
+            description: `Use when you want to bundle Jira mutations in one call: create or target an issue, then optional update, sprint assignment, transition, and comment. ${JIRA_WIKI_MARKUP_HINT}`,
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -216,7 +217,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                             project: { type: 'string', description: 'Alias for projectKey' },
                             issueType: { type: 'string', description: 'Issue type name, e.g. Bug, Story, Task' },
                             summary: { type: 'string', description: 'Issue title' },
-                            description: { type: 'string', description: 'Issue description (optional)' },
+                            description: { type: 'string', description: `Issue description (optional). ${JIRA_WIKI_MARKUP_HINT}` },
                             assignee: { type: 'string', description: 'Username to assign to (optional)' },
                             priority: { type: 'string', description: 'Priority name (optional)' },
                         },
@@ -226,7 +227,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                         type: 'object',
                         properties: {
                             summary: { type: 'string', description: 'New summary (optional)' },
-                            description: { type: 'string', description: 'New description (optional)' },
+                            description: { type: 'string', description: `New description (optional). ${JIRA_WIKI_MARKUP_HINT}` },
                             assignee: { type: 'string', description: 'New assignee username, or empty string to unassign (optional)' },
                             priority: { type: 'string', description: 'New priority name (optional)' },
                         },
@@ -234,7 +235,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                     sprintId: { type: 'number', description: 'Sprint ID to add the issue into (optional)' },
                     transitionId: { type: 'string', description: 'Transition ID (optional if transitionName is provided)' },
                     transitionName: { type: 'string', description: 'Transition name, e.g. In Progress (optional if transitionId is provided)' },
-                    comment: { type: 'string', description: 'Comment to add after other mutations (optional, no emoji)' },
+                    comment: { type: 'string', description: `Comment to add after other mutations (optional, no emoji). ${JIRA_WIKI_MARKUP_HINT}` },
                 },
             },
         },
@@ -272,12 +273,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: 'jira_add_comment',
-            description: 'Use when you want to leave a comment on a Jira ticket. Keep comments concise, plain text, and free of filler. Never include emojis.',
+            description: `Use when you want to leave a comment on a Jira ticket. Keep comments concise and free of filler. Never include emojis. ${JIRA_WIKI_MARKUP_HINT}`,
             inputSchema: {
                 type: 'object',
                 properties: {
                     issueKey: { type: 'string', description: 'Jira issue key' },
-                    body: { type: 'string', description: 'Concise comment text only. No filler. Do not include emojis.' },
+                    body: { type: 'string', description: `Concise comment text. No filler. Do not include emojis. ${JIRA_WIKI_MARKUP_HINT}` },
                 },
                 required: ['issueKey', 'body'],
             },

package/dist/jira.js

@@ -83,7 +83,7 @@ function validateCommentBody(body) {
         throw new Error('Jira comment body must not be empty.');
     }
     if (EMOJI_RE.test(trimmed)) {
-        throw new Error('Jira comments must not include emoji. Use concise plain text only.');
+        throw new Error('Jira comments must not include emoji. Use concise Jira wiki markup or plain text only.');
     }
     return trimmed;
 }
@@ -292,6 +292,7 @@ export class JiraClient {
         const f = data.fields;
         const lines = [
             `Issue: ${data.key} — ${f.summary}`,
+            `URL:        ${this.issueUrl(data.key)}`,
             `Status:     ${f.status.name}`,
             `Type:       ${f.issuetype.name}`,
             `Priority:   ${f.priority?.name ?? 'None'}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stubbedev/atlassian-mcp",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "MCP server for self-hosted Jira and Bitbucket",
   "license": "MIT",
   "type": "module",