Backlog MCP Server

Instructions

Implementation Reference

• src/tools/getWikisCount.ts:44-54 (handler)

  The handler function that executes the tool logic: resolves the project ID or key and calls the Backlog API to get the wiki count.

  handler: async ({ projectId, projectKey }) => {
    const result = resolveIdOrKey(
      'project',
      { id: projectId, key: projectKey },
      t
    );
    if (!result.ok) {
      throw result.error;
    }
    return backlog.getWikisCount(result.value);
  },

• src/tools/getWikisCount.ts:8-27 (schema)

  Input schema definition for the tool parameters (projectId or projectKey). Also references outputSchema: WikiCountSchema.

  const getWikisCountSchema = buildToolSchema((t) => ({
    projectId: z
      .number()
      .optional()
      .describe(
        t(
          'TOOL_GET_WIKIS_COUNT_PROJECT_ID',
          'The numeric ID of the project (e.g., 12345)'
        )
      ),
    projectKey: z
      .string()
      .optional()
      .describe(
        t(
          'TOOL_GET_WIKIS_COUNT_PROJECT_KEY',
          "The key of the project (e.g., 'PROJECT')"
        )
      ),
  }));

• src/tools/tools.ts:118-129 (registration)

  Registration of the getWikisCountTool in the 'wiki' toolset group within the allTools export.

  {
    name: 'wiki',
    description: 'Tools for managing wiki pages.',
    enabled: false,
    tools: [
      getWikiPagesTool(backlog, helper),
      getWikisCountTool(backlog, helper),
      getWikiTool(backlog, helper),
      addWikiTool(backlog, helper),
      updateWikiTool(backlog, helper),
    ],
  },

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

  Import of the getWikisCountTool function.

  import { getWikisCountTool } from './getWikisCount.js';