Jira MCP Server

Instructions

Implementation Reference

• src/jira-client.ts:195-199 (handler)

  Core handler function that performs the actual Jira API call to search users by username query.

  async searchUsers(query: string): Promise<JiraUser[]> {
    return this.request<JiraUser[]>(
      `/user/search?username=${encodeURIComponent(query)}`
    );
  }

• src/index.ts:1074-1080 (handler)

  MCP server dispatch handler for the tool call, validates input and delegates to JiraClient.

  case "jira_search_users": {
    const { query } = SearchUsersSchema.parse(args);
    const users = await jiraClient.searchUsers(query);
    return {
      content: [{ type: "text", text: JSON.stringify(users, null, 2) }],
    };
  }

• src/index.ts:106-108 (schema)

  Input schema validation using Zod for the tool parameters.

  const SearchUsersSchema = z.object({
    query: z.string().describe("Username search query"),
  });

• src/index.ts:390-400 (registration)

  Tool registration in the MCP listTools response, defining name, description, and input schema.

  {
    name: "jira_search_users",
    description: "Search for Jira users",
    inputSchema: {
      type: "object",
      properties: {
        query: { type: "string", description: "Username search query" },
      },
      required: ["query"],
    },
  },

• src/types.ts:88-95 (schema)

  TypeScript interface defining the structure of JiraUser objects returned by the tool.

  export interface JiraUser {
    self: string;
    key: string;
    name: string;
    emailAddress: string;
    displayName: string;
    active: boolean;
  }