Bitrefill Search and Shop

Instructions

Implementation Reference

• src/handlers/tools.ts:104-115 (handler)

  The inline handler function for the 'categories' tool, which returns a JSON-formatted string of the productCategories map.

  server.tool(
    "categories",
    "Get the full product type/categories map. It's suggested to use this tool to get the categories and then use the `search` tool to search for products in a specific category.",
    {},
    async () => {
      return {
        content: [
          { type: "text" as const, text: JSON.stringify(productCategories, null, 2) }
        ]
      };
    }
  );

• src/handlers/tools.ts:104-115 (registration)

  Registration of the 'categories' tool within the registerToolHandlers function using server.tool.

  server.tool(
    "categories",
    "Get the full product type/categories map. It's suggested to use this tool to get the categories and then use the `search` tool to search for products in a specific category.",
    {},
    async () => {
      return {
        content: [
          { type: "text" as const, text: JSON.stringify(productCategories, null, 2) }
        ]
      };
    }
  );

• src/constants/categories.ts:6-77 (helper)

  The productCategories constant/map that provides the hierarchy of product types and categories, used by the 'categories' tool.

  export const productCategories: ProductCategoriesMap = {
    "giftcards": [
      "all-gift-cards",
      "apparel",
      "automobiles",
      "cruises",
      "ecommerce",
      "electronics",
      "entertainment",
      "experiences",
      "flights",
      "food",
      "food-delivery",
      "games",
      "gifts",
      "groceries",
      "health-beauty",
      "home",
      "multi-brand",
      "music",
      "other",
      "payment-cards",
      "pets",
      "pharmacy",
      "restaurants",
      "retail",
      "streaming",
      "top-products",
      "travel",
      "utility-bills",
      "voip"
    ],
    "refills": [
      "refill",
      "data",
      "pin",
      "bundles",
      "dth"
    ],
    "bills": [
      "all-bills",
      "auto-loans",
      "banking",
      "bill",
      "catalog-sales",
      "cemeteries-funerals",
      "club-membership",
      "commission-businesses",
      "credit-card",
      "education",
      "financial-services",
      "healthcare",
      "hoa-rent",
      "installment-payments",
      "insurance",
      "internet-cable-tv",
      "mortgages-home-equity",
      "mortgages-property-management",
      "phone",
      "press",
      "sanitation",
      "security-monitoring",
      "taxes",
      "water-electricity-gas"
    ],
    "esims": [
      "esim"
    ],
    "crypto-utils": [
      "bitcoin"
    ]
  };

• src/schemas/search.ts:80-85 (schema)

  Zod schema and TypeScript type definition for the product categories map data structure.

  export const ProductCategoriesMapSchema = z.record(z.array(z.string()));
  
  /**
   * Product types and their associated categories
   */
  export type ProductCategoriesMap = z.infer<typeof ProductCategoriesMapSchema>;