Jira MCP Server

Instructions

Implementation Reference

• src/index.ts:1103-1114 (handler)

  Handler case for jira_add_watcher tool that parses arguments, calls jiraClient.addWatcher, and returns success message

  case "jira_add_watcher": {
    const { issueKey, username } = AddWatcherSchema.parse(args);
    await jiraClient.addWatcher(issueKey, username);
    return {
      content: [
        {
          type: "text",
          text: `Added ${username} as watcher to ${issueKey}`,
        },
      ],
    };
  }

• src/jira-client.ts:206-211 (helper)

  Core implementation of adding a watcher to a Jira issue via POST to /issue/{issueKey}/watchers endpoint

  async addWatcher(issueKey: string, username: string): Promise<void> {
    await this.request<void>(`/issue/${issueKey}/watchers`, {
      method: "POST",
      body: JSON.stringify(username),
    });
  }

• src/index.ts:116-119 (schema)

  Zod input schema for validating jira_add_watcher tool parameters

  const AddWatcherSchema = z.object({
    issueKey: z.string().describe("The Jira issue key"),
    username: z.string().describe("Username to add as watcher"),
  });

• src/index.ts:426-439 (registration)

  Tool registration in ListTools response including name, description, and JSON input schema

    name: "jira_add_watcher",
    description: "Add a watcher to a Jira issue",
    inputSchema: {
      type: "object",
      properties: {
        issueKey: { type: "string", description: "The Jira issue key" },
        username: {
          type: "string",
          description: "Username to add as watcher",
        },
      },
      required: ["issueKey", "username"],
    },
  },