Backlog MCP Server

Instructions

Implementation Reference

• src/tools/getPriorities.ts:9-26 (handler)

  Factory function creating the 'get_priorities' MCP tool definition. The handler asynchronously calls backlog.getPriorities() to fetch the list of priorities.

  export const getPrioritiesTool = (
    backlog: Backlog,
    { t }: TranslationHelper
  ): ToolDefinition<
    ReturnType<typeof getPrioritiesSchema>,
    (typeof PrioritySchema)['shape']
  > => {
    return {
      name: 'get_priorities',
      description: t(
        'TOOL_GET_PRIORITIES_DESCRIPTION',
        'Returns list of priorities'
      ),
      schema: z.object(getPrioritiesSchema(t)),
      outputSchema: PrioritySchema,
      handler: async () => backlog.getPriorities(),
    };
  };

• src/types/zod/backlogOutputDefinition.ts:153-156 (schema)

  Zod schema defining the structure of a Priority object, used as the output schema for the get_priorities tool.

  export const PrioritySchema = z.object({
    id: z.number(),
    name: z.string(),
  });

• src/tools/tools.ts:101-101 (registration)

  Registers the get_priorities tool by instantiating it with the Backlog instance and translation helper, adding it to the 'issue' toolset.

  getPrioritiesTool(backlog, helper),

• src/tools/getPriorities.ts:7-7 (schema)

  Defines the input schema for the get_priorities tool, which takes no parameters (empty object).

  const getPrioritiesSchema = buildToolSchema((_t) => ({}));

• src/tools/tools.ts:25-25 (registration)

  Imports the getPrioritiesTool factory function used to register the get_priorities tool.

  import { getPrioritiesTool } from './getPriorities.js';