MantisBT MCP Server

Instructions

Implementation Reference

• src/tools/projects.ts:85-115 (handler)

  The handler and registration for the 'get_project_versions' tool.

  server.registerTool(
    'get_project_versions',
    {
      title: 'Get Project Versions',
      description: 'List all versions defined for a MantisBT project.',
      inputSchema: z.object({
        project_id: z.coerce.number().int().positive().describe('Numeric project ID'),
        obsolete: z.boolean().default(false).describe('Include obsolete (deprecated) versions (default: false)'),
        inherit: z.boolean().default(false).describe('Include versions inherited from parent projects (default: false)'),
      }),
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
      },
    },
    async ({ project_id, obsolete, inherit }) => {
      try {
        const params: Record<string, number> = {};
        if (obsolete) params.obsolete = 1;
        if (inherit) params.inherit = 1;
        const result = await client.get<{ versions: MantisVersion[] }>(`projects/${project_id}/versions`, params);
        return {
          content: [{ type: 'text', text: JSON.stringify(result.versions ?? result, null, 2) }],
        };
      } catch (error) {
        const msg = error instanceof Error ? error.message : String(error);
        return { content: [{ type: 'text', text: errorText(msg) }], isError: true };
      }
    }
  );