BookStack MCP Server

Instructions

Implementation Reference

• src/tools/content-tools.ts:547-551 (handler)

  The handler case for 'list_books' that validates input with PaginationSchema, calls client.getBooks(params), and formats the paginated response using formatApiResponse.

  case "list_books": {
    const params = PaginationSchema.parse(args);
    const result = await client.getBooks(params);
    return formatApiResponse(result.data, result.total);
  }

• src/tools/content-tools.ts:35-46 (schema)

  Tool metadata and input schema definition for 'list_books', specifying optional pagination parameters.

  {
    name: "list_books",
    description: "Get a listing of books visible to the user",
    inputSchema: {
      type: "object",
      properties: {
        page: { type: "number", description: "Page number for pagination" },
        count: { type: "number", description: "Number of items per page" },
        sort: { type: "string", description: "Sort parameter" },
      },
    },
  },

• src/lib/validation.ts:5-11 (schema)

  Zod validation schema for pagination parameters used in the list_books handler.

  export const PaginationSchema = z
    .object({
      page: z.number().optional(),
      count: z.number().optional(),
      sort: z.string().optional(),
    })
    .optional();

• src/index.ts:56-59 (registration)

  Incorporates the list_books tool (via createContentTools) into the complete list of tools advertised to the MCP client via listTools.

  const allTools: Tool[] = [
    ...createContentTools(bookStackClient),
    ...createSearchAndUserTools(bookStackClient),
  ];

• src/index.ts:124-127 (registration)

  Dispatch logic in callTool handler that routes 'list_books' calls (as part of contentToolNames) to the appropriate handleContentTool function.

  if (contentToolNames.includes(name)) {
    result = await handleContentTool(name, args, bookStackClient);
  } else if (searchUserToolNames.includes(name)) {
    result = await handleSearchAndUserTool(name, args, bookStackClient);