@ecubelabs/atlassian-mcp 1.1.0-next.1 → 1.1.0

package/dist/index.js

@@ -25,7 +25,7 @@ server.tool("get-issue", "Get details of a Jira issue by key", {
     ])
         .array()
         .optional()
-        .describe("Optional fields to expand in the response"),
+        .describe("Optional fields to expand in the response. Options include: renderedFields (HTML format), names (display names), schema (field type descriptions), transitions (possible transitions), editmeta (field editing info), changelog (recent updates), versionedRepresentations (field value history)"),
 }, async ({ issueKey, expand }) => {
     try {
         const issue = await jiraService.getIssue(issueKey, expand);
@@ -50,10 +50,23 @@ server.tool("get-issue", "Get details of a Jira issue by key", {
     }
 });
 server.tool("search-issues", "Search Jira issues using JQL", {
-    jql: z.string().describe("JQL query string"),
-    fields: z.array(z.string()).optional().describe("Fields to include"),
-    maxResults: z.number().min(1).max(5000).optional().describe("Max results"),
-    nextPageToken: z.string().optional().describe("Next page token"),
+    jql: z
+        .string()
+        .describe("JQL query string. Must be a bounded query with search restrictions."),
+    fields: z
+        .array(z.string())
+        .optional()
+        .describe("Optional fields to include in the response. Examples: ['summary', 'comment'] or ['*all', '-comment']"),
+    maxResults: z
+        .number()
+        .min(1)
+        .max(5000)
+        .optional()
+        .describe("Maximum number of results to return per page (default: 50, max: 5000)"),
+    nextPageToken: z
+        .string()
+        .optional()
+        .describe("Token for fetching the next page of results. The first page has null nextPageToken."),
     expand: z
         .enum([
         "renderedFields",
@@ -66,11 +79,25 @@ server.tool("search-issues", "Search Jira issues using JQL", {
     ])
         .array()
         .optional()
-        .describe("Fields to expand"),
-    properties: z.array(z.string()).max(5).optional().describe("Properties to include"),
-    fieldsByKeys: z.boolean().optional().describe("Use field keys"),
-    failFast: z.boolean().optional().describe("Fail fast mode"),
-    reconcileIssues: z.array(z.number()).max(50).optional().describe("Issue IDs to reconcile"),
+        .describe("Comma-separated values to expand in response: renderedFields, names, schema, transitions, operations, editmeta, changelog, versionedRepresentations"),
+    properties: z
+        .array(z.string())
+        .max(5)
+        .optional()
+        .describe("List of up to 5 issue properties to include in results"),
+    fieldsByKeys: z
+        .boolean()
+        .optional()
+        .describe("Reference fields by their key rather than ID (default: false)"),
+    failFast: z
+        .boolean()
+        .optional()
+        .describe("Fail request early if we can't retrieve all field data (default: false)"),
+    reconcileIssues: z
+        .array(z.number())
+        .max(50)
+        .optional()
+        .describe("Strong consistency issue IDs to be reconciled with search results (max: 50 IDs)"),
 }, async ({ jql, fields, maxResults, nextPageToken, expand, properties, fieldsByKeys, failFast, reconcileIssues, }) => {
     try {
         const issues = await jiraService.searchIssues({
@@ -106,10 +133,25 @@ server.tool("search-issues", "Search Jira issues using JQL", {
 });
 server.tool("get-comments", "Get comments for a Jira issue", {
     issueKey: z.string().describe("Jira issue key (e.g. PROJ-123)"),
-    startAt: z.number().min(0).optional().describe("Page offset"),
-    maxResults: z.number().min(1).max(100).optional().describe("Max results"),
-    orderBy: z.enum(["created", "-created", "+created"]).optional().describe("Order by"),
-    expand: z.array(z.enum(["renderedBody"])).optional().describe("Fields to expand"),
+    startAt: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("The index of the first item to return (page offset). Default: 0"),
+    maxResults: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Maximum number of items per page. Default: 100"),
+    orderBy: z
+        .enum(["created", "-created", "+created"])
+        .optional()
+        .describe("Order comments by creation date. Default: created"),
+    expand: z
+        .array(z.enum(["renderedBody"]))
+        .optional()
+        .describe("Include additional information: renderedBody (comment body in HTML format)"),
 }, async ({ issueKey, startAt, maxResults, orderBy, expand }) => {
     try {
         const result = await jiraService.getComments(issueKey, {
@@ -139,29 +181,88 @@ server.tool("get-comments", "Get comments for a Jira issue", {
     }
 });
 server.tool("get-projects", "Get list of Jira projects", {
-    startAt: z.number().min(0).optional().describe("Page offset"),
-    maxResults: z.number().min(1).max(100).optional().describe("Max results"),
+    startAt: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("The index of the first item to return (page offset). Default: 0"),
+    maxResults: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Maximum number of items per page. Default: 50, Maximum: 100"),
     orderBy: z
         .enum([
-        "category", "-category", "+category",
-        "key", "-key", "+key",
-        "name", "-name", "+name",
-        "owner", "-owner", "+owner",
-        "issueCount", "-issueCount", "+issueCount",
-        "lastIssueUpdatedTime", "-lastIssueUpdatedTime", "+lastIssueUpdatedTime",
-        "archivedDate", "-archivedDate", "+archivedDate",
-        "deletedDate", "-deletedDate", "+deletedDate"
+        "category",
+        "-category",
+        "+category",
+        "key",
+        "-key",
+        "+key",
+        "name",
+        "-name",
+        "+name",
+        "owner",
+        "-owner",
+        "+owner",
+        "issueCount",
+        "-issueCount",
+        "+issueCount",
+        "lastIssueUpdatedTime",
+        "-lastIssueUpdatedTime",
+        "+lastIssueUpdatedTime",
+        "archivedDate",
+        "-archivedDate",
+        "+archivedDate",
+        "deletedDate",
+        "-deletedDate",
+        "+deletedDate",
     ])
         .optional()
-        .describe("Sort order"),
-    id: z.array(z.number().int()).max(50).optional().describe("Project IDs"),
-    keys: z.array(z.string()).max(50).optional().describe("Project keys"),
-    query: z.string().optional().describe("Search query"),
-    typeKey: z.string().optional().describe("Project type"),
-    categoryId: z.number().int().optional().describe("Category ID"),
-    action: z.enum(["view", "browse", "edit", "create"]).optional().describe("Permission filter"),
-    expand: z.array(z.enum(["description", "projectKeys", "lead", "issueTypes", "url", "insight"])).optional().describe("Fields to expand"),
-    status: z.array(z.enum(["live", "archived", "deleted"])).optional().describe("Status filter"),
+        .describe("Field to order results by. Default: key"),
+    id: z
+        .array(z.number().int())
+        .max(50)
+        .optional()
+        .describe("Filter by project IDs. Maximum: 50 IDs"),
+    keys: z
+        .array(z.string())
+        .max(50)
+        .optional()
+        .describe("Filter by project keys. Maximum: 50 keys"),
+    query: z
+        .string()
+        .optional()
+        .describe("Filter by matching key or name (case insensitive)"),
+    typeKey: z
+        .string()
+        .optional()
+        .describe("Filter by project type. Accepts comma-separated list: business, service_desk, software"),
+    categoryId: z
+        .number()
+        .int()
+        .optional()
+        .describe("Filter by project category ID"),
+    action: z
+        .enum(["view", "browse", "edit", "create"])
+        .optional()
+        .describe("Filter by user's project permissions. Default: view"),
+    expand: z
+        .array(z.enum([
+        "description",
+        "projectKeys",
+        "lead",
+        "issueTypes",
+        "url",
+        "insight",
+    ]))
+        .optional()
+        .describe("Additional fields to include: description, projectKeys, lead, issueTypes, url, insight"),
+    status: z
+        .array(z.enum(["live", "archived", "deleted"]))
+        .optional()
+        .describe("EXPERIMENTAL. Filter by project status"),
 }, async ({ startAt, maxResults, orderBy, id, keys, query, typeKey, categoryId, action, expand, status, }) => {
     try {
         const projects = await jiraService.getProjects({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecubelabs/atlassian-mcp",
-  "version": "1.1.0-next.1",
+  "version": "1.1.0",
   "bin": "./dist/index.js",
   "repository": {
     "url": "https://github.com/Ecube-Labs/skynet.git"
@@ -32,6 +32,5 @@
     "semantic-release-yarn": "^3.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.2"
-  },
-  "stableVersion": "1.0.0"
+  }
 }