Kroger MCP Server

Instructions

Implementation Reference

• src/kroger_mcp/tools/product_tools.py:280-396 (handler)

  The handler function that implements the get_product_details tool. It fetches product details from the Kroger API, formats pricing, aisle locations, images, and other information.
  @mcp.tool() async def get_product_details( product_id: str, location_id: Optional[str] = None, ctx: Context = None ) -> Dict[str, Any]: """ Get detailed information about a specific product. Args: product_id: The unique product identifier location_id: Store location ID for pricing/availability (uses preferred if not provided) Returns: Dictionary containing detailed product information """ # Use preferred location if none provided if not location_id: location_id = get_preferred_location_id() if not location_id: return { "success": False, "error": "No location_id provided and no preferred location set. Use set_preferred_location first." } if ctx: await ctx.info(f"Getting details for product {product_id} at location {location_id}") client = get_client_credentials_client() try: product_details = client.product.get_product( product_id=product_id, location_id=location_id ) if not product_details or "data" not in product_details: return { "success": False, "message": f"Product {product_id} not found" } product = product_details["data"] # Format the detailed product information result = { "success": True, "product_id": product.get("productId"), "upc": product.get("upc"), "description": product.get("description"), "brand": product.get("brand"), "categories": product.get("categories", []), "country_origin": product.get("countryOrigin"), "temperature": product.get("temperature", {}), "location_id": location_id } # Add detailed item information if "items" in product and product["items"]: item = product["items"][0] result["item_details"] = { "size": item.get("size"), "sold_by": item.get("soldBy"), "inventory": item.get("inventory", {}), "fulfillment": item.get("fulfillment", {}) } # Add detailed pricing if "price" in item: price = item["price"] result["pricing"] = { "regular_price": price.get("regular"), "sale_price": price.get("promo"), "regular_per_unit": price.get("regularPerUnitEstimate"), "formatted_regular": format_currency(price.get("regular")), "formatted_sale": format_currency(price.get("promo")), "on_sale": price.get("promo") is not None and price.get("promo") < price.get("regular", float('inf')), "savings": price.get("regular", 0) - price.get("promo", price.get("regular", 0)) if price.get("promo") else 0 } # Add aisle locations if "aisleLocations" in product: result["aisle_locations"] = [ { "description": aisle.get("description"), "aisle_number": aisle.get("number"), "side": aisle.get("side"), "shelf_number": aisle.get("shelfNumber") } for aisle in product["aisleLocations"] ] # Add images if "images" in product and product["images"]: result["images"] = [ { "perspective": img.get("perspective"), "sizes": [ { "size": size.get("size"), "url": size.get("url") } for size in img.get("sizes", []) ] } for img in product["images"] ] return result except Exception as e: if ctx: await ctx.error(f"Error getting product details: {str(e)}") return { "success": False, "error": str(e) }
• src/kroger_mcp/server.py:71-78 (registration)

  Registration of all tool modules, including product_tools.register_tools(mcp) which registers the get_product_details tool.
  # Register all tools from the modules location_tools.register_tools(mcp) product_tools.register_tools(mcp) cart_tools.register_tools(mcp) info_tools.register_tools(mcp) profile_tools.register_tools(mcp) utility_tools.register_tools(mcp) auth_tools.register_tools(mcp)
• src/kroger_mcp/tools/product_tools.py:18-21 (registration)

  The register_tools function in product_tools.py that defines and registers the get_product_details tool along with other product tools.
  def register_tools(mcp): """Register product-related tools with the FastMCP server""" @mcp.tool()