get_faqs_by_category

Retrieve frequently asked questions for a specific support category to quickly find relevant answers and solutions for user inquiries.

Instructions

Get all FAQs for a specific category

Input Schema

TableJSON Schema

Name	Required	Description	Default
`category`	Yes

Implementation Reference

src/tools/chatbot.tools.ts:177-225 (handler)

The execute handler function for the 'get_faqs_by_category' tool. It validates the category input, fetches FAQs using the chatbot service, formats the response as JSON, and handles errors.

  execute: async (args: { category: string }) => {
    try {
      logger.info('Getting FAQs by category', args);

      validateNotEmpty(args.category, 'Category');

      const faqs = chatbotService.getFAQsByCategory(args.category);

      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: true,
                category: args.category,
                count: faqs.length,
                faqs: faqs.map(faq => ({
                  question: faq.question,
                  answer: faq.answer
                }))
              },
              null,
              2
            )
          }
        ]
      };
    } catch (error) {
      logger.error('Failed to get FAQs by category', error);
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                success: false,
                error: error instanceof Error ? error.message : 'Unknown error'
              },
              null,
              2
            )
          }
        ],
        isError: true
      };
    }
  }
},

src/tools/chatbot.tools.ts:174-176 (schema)
Zod input schema defining the required 'category' parameter as a string.
```
parameters: z.object({
  category: z.string().describe('Category name to filter FAQs')
}),
```

src/index.ts:60-68 (registration)

Registration of the chatbot tools (including get_faqs_by_category) by creating the tools object via createChatbotTools and merging it into the allTools object used by MCP request handlers.

const ticketTools = createTicketTools(apiService);
const chatbotTools = createChatbotTools(chatbotService);
const pdfTools = createPDFTools(pdfService);

const allTools = {
  ...ticketTools,
  ...chatbotTools,
  ...pdfTools
};

src/services/chatbot.service.ts:249-253 (helper)
Helper method in ChatbotService that filters the hardcoded list of SupportFAQs by the given category (case-insensitive). Called by the tool handler.
```
getFAQsByCategory(category: string): SupportFAQ[] {
  return this.faqs.filter(faq => 
    faq.category.toLowerCase() === category.toLowerCase()
  );
}
```

FitSlot MCP Server