@universal-mcp-toolkit/server-jira 0.1.0

package/.well-known/mcp-server.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json.schemastore.org/json",
+  "name": "jira",
+  "title": "Jira MCP Server",
+  "description": "Search Jira Cloud issues, inspect tickets, transition work, and fetch project context.",
+  "version": "0.1.0",
+  "packageName": "@universal-mcp-toolkit/server-jira",
+  "homepage": "https://github.com/universal-mcp-toolkit/universal-mcp-toolkit#readme",
+  "repositoryUrl": "https://github.com/universal-mcp-toolkit/universal-mcp-toolkit",
+  "documentationUrl": "https://github.com/universal-mcp-toolkit/universal-mcp-toolkit/tree/main/servers/jira",
+  "transports": [
+    "stdio",
+    "sse"
+  ],
+  "authentication": {
+    "mode": "environment-variables",
+    "required": [
+      "JIRA_BASE_URL",
+      "JIRA_EMAIL",
+      "JIRA_API_TOKEN"
+    ],
+    "optional": [
+      "JIRA_DEFAULT_PROJECT_KEY"
+    ]
+  },
+  "capabilities": {
+    "tools": true,
+    "resources": true,
+    "prompts": true
+  },
+  "tools": [
+    {
+      "name": "get_issue",
+      "description": "Fetch a Jira issue with normalized fields, description text, and comments."
+    },
+    {
+      "name": "search_issues",
+      "description": "Search Jira issues with JQL or structured filters and return normalized issue summaries."
+    },
+    {
+      "name": "transition_issue",
+      "description": "Resolve a Jira transition by name or id, apply it, and return the updated issue."
+    }
+  ],
+  "resources": [
+    {
+      "name": "project",
+      "uriTemplate": "jira://projects/{projectKey}",
+      "mimeType": "application/json",
+      "description": "Return normalized Jira project metadata as JSON."
+    }
+  ],
+  "prompts": [
+    {
+      "name": "incident_triage",
+      "description": "Create a reusable incident-triage prompt using Jira issue context."
+    }
+  ],
+  "examples": {
+    "toolCalls": [
+      {
+        "name": "search_issues",
+        "arguments": {
+          "text": "latency spike",
+          "maxResults": 5
+        }
+      },
+      {
+        "name": "get_issue",
+        "arguments": {
+          "issueKey": "OPS-42"
+        }
+      },
+      {
+        "name": "transition_issue",
+        "arguments": {
+          "issueKey": "OPS-42",
+          "transitionName": "Done",
+          "comment": "Mitigation deployed and metrics recovered."
+        }
+      }
+    ],
+    "resourceUris": [
+      "jira://projects/OPS"
+    ]
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 universal-mcp-toolkit
+
+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/dist/index.d.ts

@@ -0,0 +1,240 @@
+import * as _universal_mcp_toolkit_core from '@universal-mcp-toolkit/core';
+import { ToolkitServer, ToolkitServerMetadata } from '@universal-mcp-toolkit/core';
+import { z } from 'zod';
+
+declare const jiraIssueSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    summary: z.ZodString;
+    status: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    assignee: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodString;
+        emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    reporter: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodString;
+        emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    priority: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    issueType: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        subtask: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    project: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+}, z.core.$strip>;
+declare const jiraIssueDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    summary: z.ZodString;
+    status: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    assignee: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodString;
+        emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    reporter: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodString;
+        emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    priority: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    issueType: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        subtask: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    project: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    created: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+    comments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        author: z.ZodOptional<z.ZodObject<{
+            accountId: z.ZodOptional<z.ZodString>;
+            displayName: z.ZodString;
+            emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>;
+        body: z.ZodString;
+        created: z.ZodOptional<z.ZodString>;
+        updated: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const jiraTransitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    toStatus: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const jiraProjectSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    projectTypeKey: z.ZodOptional<z.ZodString>;
+    simplified: z.ZodOptional<z.ZodBoolean>;
+    lead: z.ZodOptional<z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodString;
+        emailAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    assigneeType: z.ZodOptional<z.ZodString>;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const incidentTriagePromptArgsShape: {
+    issueKey: z.ZodOptional<z.ZodString>;
+    projectKey: z.ZodOptional<z.ZodString>;
+    summary: z.ZodString;
+    symptoms: z.ZodString;
+    impact: z.ZodOptional<z.ZodString>;
+    suspectedService: z.ZodOptional<z.ZodString>;
+    environment: z.ZodOptional<z.ZodString>;
+};
+type IncidentTriagePromptArgs = z.infer<z.ZodObject<typeof incidentTriagePromptArgsShape>>;
+type JiraIssueSummary = z.infer<typeof jiraIssueSummarySchema>;
+type JiraIssueDetail = z.infer<typeof jiraIssueDetailSchema>;
+type JiraTransition = z.infer<typeof jiraTransitionSchema>;
+type JiraProject = z.infer<typeof jiraProjectSchema>;
+interface JiraEnvironment {
+    readonly baseUrl: string;
+    readonly email: string;
+    readonly apiToken: string;
+    readonly defaultProjectKey?: string;
+}
+interface JiraSearchRequest {
+    readonly jql: string;
+    readonly startAt: number;
+    readonly maxResults: number;
+    readonly fields: readonly string[];
+}
+interface JiraSearchResult {
+    readonly startAt: number;
+    readonly maxResults: number;
+    readonly total: number;
+    readonly issues: readonly JiraIssueSummary[];
+}
+interface JiraClient {
+    searchIssues(request: JiraSearchRequest): Promise<JiraSearchResult>;
+    getIssue(issueKey: string, fields?: readonly string[]): Promise<JiraIssueDetail>;
+    getTransitions(issueKey: string): Promise<readonly JiraTransition[]>;
+    transitionIssue(issueKey: string, transitionId: string, comment?: string): Promise<void>;
+    getProject(projectKey: string): Promise<JiraProject>;
+}
+interface JiraRestClientOptions {
+    readonly environment: JiraEnvironment;
+    readonly fetchImpl?: typeof fetch;
+}
+interface JiraServerOptions {
+    readonly client?: JiraClient;
+    readonly environment?: JiraEnvironment;
+    readonly envSource?: NodeJS.ProcessEnv;
+}
+declare function loadJiraEnvironment(source?: NodeJS.ProcessEnv): JiraEnvironment;
+declare class JiraRestClient implements JiraClient {
+    private readonly environment;
+    private readonly fetchImpl;
+    constructor(options: JiraRestClientOptions);
+    searchIssues(request: JiraSearchRequest): Promise<JiraSearchResult>;
+    getIssue(issueKey: string, fields?: readonly string[]): Promise<JiraIssueDetail>;
+    getTransitions(issueKey: string): Promise<readonly JiraTransition[]>;
+    transitionIssue(issueKey: string, transitionId: string, comment?: string): Promise<void>;
+    getProject(projectKey: string): Promise<JiraProject>;
+    private createUrl;
+    private createHeaders;
+    private requestJson;
+    private requestVoid;
+    private request;
+    private tryParseJson;
+}
+declare const metadata: ToolkitServerMetadata;
+declare const serverCard: _universal_mcp_toolkit_core.ToolkitServerCard;
+declare class JiraServer extends ToolkitServer {
+    private readonly client;
+    private readonly environment;
+    constructor(options?: JiraServerOptions);
+    readProjectResource(projectKey: string, uri?: string): Promise<{
+        [x: string]: unknown;
+        contents: ({
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    buildIncidentTriagePrompt(args: IncidentTriagePromptArgs): {
+        messages: ({
+            role: "assistant";
+            content: {
+                type: "text";
+                text: string;
+            };
+        } | {
+            role: "user";
+            content: {
+                type: "text";
+                text: string;
+            };
+        })[];
+    };
+    private createSearchIssuesTool;
+    private createGetIssueTool;
+    private createTransitionIssueTool;
+    private registerProjectResource;
+    private registerIncidentTriagePrompt;
+}
+declare function createServer(options?: JiraServerOptions): JiraServer;
+declare const runtimeRegistration: {
+    createServer: typeof createServer;
+    serverCard: _universal_mcp_toolkit_core.ToolkitServerCard;
+};
+declare function main(argv?: readonly string[]): Promise<void>;
+
+export { type JiraClient, type JiraEnvironment, JiraRestClient, type JiraRestClientOptions, type JiraSearchRequest, type JiraSearchResult, JiraServer, type JiraServerOptions, createServer, runtimeRegistration as default, loadJiraEnvironment, main, metadata, serverCard };