Woolworths MCP Server

Instructions

Implementation Reference

• src/index.ts:460-498 (handler)

  The handler function that executes the tool logic: adds the specified product (by stockcode) and quantity to the Woolworths shopping cart by posting to the trolley update API endpoint.

  async function handleAddToCart(args: any): Promise<any> {
    const stockcode = args.stockcode;
    const quantity = args.quantity ?? 1;
  
    const url = `https://www.woolworths.com.au/api/v3/ui/trolley/update`;
  
    try {
      const data = await makeWoolworthsRequest(url, {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          items: [
            {
              stockcode,
              quantity,
              source: "ProductDetail",
              diagnostics: "0",
              searchTerm: null,
              evaluateRewardPoints: false,
              offerId: null,
              profileId: null,
              priceLevel: null,
            },
          ],
        }),
      });
      return {
        success: true,
        cart: data,
      };
    } catch (error: any) {
      return {
        success: false,
        error: error.message,
      };
    }
  }

• src/index.ts:144-161 (registration)

  Registration of the tool in the TOOLS array used for listing tools, including name, description, and input schema.

    name: "woolworths_add_to_cart",
    description: "Add a product to the shopping cart/trolley",
    inputSchema: {
      type: "object",
      properties: {
        stockcode: {
          type: "number",
          description: "The product stockcode/ID to add",
        },
        quantity: {
          type: "number",
          description: "Quantity to add (default: 1)",
          default: 1,
        },
      },
      required: ["stockcode"],
    },
  },

• src/index.ts:655-657 (registration)

  Registration/dispatch of the tool handler in the main switch statement for tool calls.

  case "woolworths_add_to_cart":
    result = await handleAddToCart(args || {});
    break;

• src/index.ts:210-248 (helper)

  Supporting utility function to perform authenticated fetch requests to Woolworths APIs, using session cookies; called by the add-to-cart handler.

  async function makeWoolworthsRequest(
    url: string,
    options: any = {}
  ): Promise<any> {
    if (sessionCookies.length === 0) {
      throw new Error(
        "No session cookies available. Please use woolworths_get_cookies first."
      );
    }
  
    const headers = {
      "User-Agent":
        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
      Accept: "*/*",
      "Accept-Language": "en-US,en;q=0.9",
      Origin: "https://www.woolworths.com.au",
      Referer: "https://www.woolworths.com.au/",
      "sec-fetch-dest": "empty",
      "sec-fetch-mode": "cors",
      "sec-fetch-site": "same-origin",
      Priority: "u=1, i",
      Cookie: getCookieHeader(),
      ...options.headers,
    };
  
    const response = await fetch(url, {
      ...options,
      headers,
    });
  
    if (!response.ok) {
      const errorText = await response.text();
      throw new Error(
        `API request failed: ${response.status} ${response.statusText}. ${errorText}`
      );
    }
  
    return response.json();
  }