@striderlabs/mcp-bjs 0.1.0

package/src/index.ts

@@ -0,0 +1,540 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import {
+  checkLoginStatus,
+  initiateLogin,
+  logout,
+  searchProducts,
+  getProductDetails,
+  checkClubInventory,
+  addToCart,
+  viewCart,
+  removeFromCart,
+  startCheckout,
+  getMembershipInfo,
+  renewMembership,
+  getCoupons,
+  clipCoupon,
+  getMyClippedCoupons,
+  getOrderHistory,
+  getOrderDetails,
+  findClubs,
+  getGasPrices,
+  closeBrowser,
+} from "./browser.js";
+
+const server = new Server(
+  { name: "strider-bjs", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+
+// ── Tool definitions ──────────────────────────────────────────────────────────
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    // Auth
+    {
+      name: "bjs_status",
+      description: "Check BJ's Wholesale Club login status and membership session.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+      name: "bjs_login",
+      description: "Initiate BJ's login flow. Returns the login URL for manual sign-in.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+      name: "bjs_logout",
+      description: "Log out of BJ's and clear saved session data.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    // Products
+    {
+      name: "bjs_search",
+      description:
+        "Search for products on BJ's Wholesale Club website. Returns product names, prices, and availability.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: {
+            type: "string",
+            description: "Product search query (e.g. 'paper towels', 'samsung tv')",
+          },
+          maxResults: {
+            type: "number",
+            description: "Maximum number of results to return (default: 10)",
+          },
+          clubId: {
+            type: "string",
+            description: "Optional club ID to filter results for a specific club",
+          },
+        },
+        required: ["query"],
+      },
+    },
+    {
+      name: "bjs_product_details",
+      description:
+        "Get full product details and pricing for a specific BJ's product by URL.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          productUrl: {
+            type: "string",
+            description: "Product page URL (from bjs_search results)",
+          },
+        },
+        required: ["productUrl"],
+      },
+    },
+    {
+      name: "bjs_check_inventory",
+      description:
+        "Check if a product is in stock at a specific BJ's club location.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          productUrl: {
+            type: "string",
+            description: "Product page URL (from bjs_search results)",
+          },
+          clubId: {
+            type: "string",
+            description: "Optional club ID to check inventory at a specific club",
+          },
+        },
+        required: ["productUrl"],
+      },
+    },
+    // Cart & Checkout
+    {
+      name: "bjs_add_to_cart",
+      description: "Add a product to the BJ's shopping cart.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          productUrl: {
+            type: "string",
+            description: "Product page URL (from bjs_search results)",
+          },
+          quantity: {
+            type: "number",
+            description: "Quantity to add (default: 1)",
+          },
+        },
+        required: ["productUrl"],
+      },
+    },
+    {
+      name: "bjs_view_cart",
+      description: "View all items in the current BJ's shopping cart with totals.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+      name: "bjs_remove_from_cart",
+      description: "Remove an item from the BJ's shopping cart by name.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          itemName: {
+            type: "string",
+            description: "Name (or partial name) of the item to remove",
+          },
+        },
+        required: ["itemName"],
+      },
+    },
+    {
+      name: "bjs_checkout",
+      description:
+        "Initiate checkout for the current cart. Supports in-club pickup, delivery, or shipping.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          fulfillmentType: {
+            type: "string",
+            enum: ["pickup", "delivery", "ship"],
+            description: "How to receive the order: 'pickup' (in-club), 'delivery', or 'ship'",
+          },
+        },
+        required: ["fulfillmentType"],
+      },
+    },
+    // Membership
+    {
+      name: "bjs_membership_info",
+      description:
+        "Get BJ's membership details: membership number, type, expiry, and rewards.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+      name: "bjs_membership_renew",
+      description: "Navigate to the BJ's membership renewal page.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    // Coupons
+    {
+      name: "bjs_coupons",
+      description: "Browse available BJ's digital coupons and offers.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          category: {
+            type: "string",
+            description: "Optional category filter (e.g. 'grocery', 'electronics', 'household')",
+          },
+        },
+        required: [],
+      },
+    },
+    {
+      name: "bjs_clip_coupon",
+      description: "Clip a digital coupon to your BJ's membership card.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          couponId: {
+            type: "string",
+            description: "Coupon ID from bjs_coupons results",
+          },
+        },
+        required: ["couponId"],
+      },
+    },
+    {
+      name: "bjs_my_coupons",
+      description: "View all coupons you have clipped to your BJ's membership card.",
+      inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    // Orders
+    {
+      name: "bjs_order_history",
+      description: "View past BJ's orders.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          maxOrders: {
+            type: "number",
+            description: "Maximum number of orders to return (default: 10)",
+          },
+        },
+        required: [],
+      },
+    },
+    {
+      name: "bjs_order_details",
+      description: "Get details for a specific BJ's order by order ID.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          orderId: {
+            type: "string",
+            description: "Order ID from bjs_order_history results",
+          },
+        },
+        required: ["orderId"],
+      },
+    },
+    // Clubs & Gas
+    {
+      name: "bjs_find_clubs",
+      description: "Find BJ's Wholesale Club locations near a zip code.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          zipCode: {
+            type: "string",
+            description: "Zip code to search near",
+          },
+          radius: {
+            type: "number",
+            description: "Search radius in miles (default: 25)",
+          },
+        },
+        required: ["zipCode"],
+      },
+    },
+    {
+      name: "bjs_gas_prices",
+      description:
+        "Get current gas prices at BJ's fuel stations. Includes regular, premium, and diesel prices.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          zipCode: {
+            type: "string",
+            description: "Optional zip code to filter nearby gas stations",
+          },
+        },
+        required: [],
+      },
+    },
+  ],
+}));
+
+// ── Tool handlers ─────────────────────────────────────────────────────────────
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      // Auth
+      case "bjs_status": {
+        const status = await checkLoginStatus();
+        return {
+          content: [{ type: "text", text: JSON.stringify(status, null, 2) }],
+        };
+      }
+
+      case "bjs_login": {
+        const result = await initiateLogin();
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "bjs_logout": {
+        const result = await logout();
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      // Products
+      case "bjs_search": {
+        const { query, maxResults, clubId } = args as {
+          query: string;
+          maxResults?: number;
+          clubId?: string;
+        };
+        const results = await searchProducts(query, maxResults ?? 10, clubId);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { query, resultCount: results.length, results },
+                null,
+                2
+              ),
+            },
+          ],
+        };
+      }
+
+      case "bjs_product_details": {
+        const { productUrl } = args as { productUrl: string };
+        const details = await getProductDetails(productUrl);
+        return {
+          content: [{ type: "text", text: JSON.stringify(details, null, 2) }],
+        };
+      }
+
+      case "bjs_check_inventory": {
+        const { productUrl, clubId } = args as {
+          productUrl: string;
+          clubId?: string;
+        };
+        const result = await checkClubInventory(productUrl, clubId);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      // Cart & Checkout
+      case "bjs_add_to_cart": {
+        const { productUrl, quantity } = args as {
+          productUrl: string;
+          quantity?: number;
+        };
+        const result = await addToCart(productUrl, quantity ?? 1);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "bjs_view_cart": {
+        const cart = await viewCart();
+        return {
+          content: [{ type: "text", text: JSON.stringify(cart, null, 2) }],
+        };
+      }
+
+      case "bjs_remove_from_cart": {
+        const { itemName } = args as { itemName: string };
+        const result = await removeFromCart(itemName);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "bjs_checkout": {
+        const { fulfillmentType } = args as {
+          fulfillmentType: "pickup" | "delivery" | "ship";
+        };
+        const result = await startCheckout(fulfillmentType);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      // Membership
+      case "bjs_membership_info": {
+        const info = await getMembershipInfo();
+        return {
+          content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+        };
+      }
+
+      case "bjs_membership_renew": {
+        const result = await renewMembership();
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      // Coupons
+      case "bjs_coupons": {
+        const { category } = args as { category?: string };
+        const coupons = await getCoupons(category);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { count: coupons.length, coupons },
+                null,
+                2
+              ),
+            },
+          ],
+        };
+      }
+
+      case "bjs_clip_coupon": {
+        const { couponId } = args as { couponId: string };
+        const result = await clipCoupon(couponId);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "bjs_my_coupons": {
+        const coupons = await getMyClippedCoupons();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { count: coupons.length, coupons },
+                null,
+                2
+              ),
+            },
+          ],
+        };
+      }
+
+      // Orders
+      case "bjs_order_history": {
+        const { maxOrders } = args as { maxOrders?: number };
+        const orders = await getOrderHistory(maxOrders ?? 10);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { count: orders.length, orders },
+                null,
+                2
+              ),
+            },
+          ],
+        };
+      }
+
+      case "bjs_order_details": {
+        const { orderId } = args as { orderId: string };
+        const details = await getOrderDetails(orderId);
+        return {
+          content: [{ type: "text", text: JSON.stringify(details, null, 2) }],
+        };
+      }
+
+      // Clubs & Gas
+      case "bjs_find_clubs": {
+        const { zipCode, radius } = args as {
+          zipCode: string;
+          radius?: number;
+        };
+        const clubs = await findClubs(zipCode, radius ?? 25);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { zipCode, radius: radius ?? 25, count: clubs.length, clubs },
+                null,
+                2
+              ),
+            },
+          ],
+        };
+      }
+
+      case "bjs_gas_prices": {
+        const { zipCode } = args as { zipCode?: string };
+        const result = await getGasPrices(zipCode);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      default:
+        return {
+          content: [
+            { type: "text", text: `Unknown tool: ${name}` },
+          ],
+          isError: true,
+        };
+    }
+  } catch (error: unknown) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              error: message,
+              tool: name,
+              hint: "Make sure you are logged in with bjs_login, then bjs_status to confirm.",
+            },
+            null,
+            2
+          ),
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// ── Start ─────────────────────────────────────────────────────────────────────
+
+server.onclose = async () => {
+  await closeBrowser();
+};
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(console.error);

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"]
+}