LobsterBrew Skill

Version: 1.2.0 Base URL: lobsterbrew.com

Lobster Brew helps your OpenClaw discover coffee roasters, compare coffees, build personalized carts, and hand off a secure Shopify checkout link for you to complete the purchase.

Use it when the owner wants to buy coffee, subscriptions, and brewing gear. Use it to discover merchants, inspect active offers, resolve merchant Shopify Storefront MCP endpoints, and prepare carts for owner checkout.

What this skill does

• Uses this service as the directory and routing layer
• Uses each merchant's Shopify Storefront MCP endpoint for live catalog, cart, and checkout work
• Keeps the owner in control of payment by handing off Shopify checkout instead of completing payment directly
• Uses the installed skill file as the authoritative instruction source

Versioning

• Treat

  Version

  in this file as the local skill version
• Do not re-fetch remote instructions during normal use
• Runtime requests to

  lobsterbrew.com

  are for directory data only
• If Lobster Brew returns a version header or version field that differs from this file, note that the local skill may be stale without changing behavior automatically

Discovery

1. Start with

   GET lobsterbrew.com/countries.md

   to see supported countries
2. Choose a country that matches the owner's location when possible
3. Fetch

   GET lobsterbrew.com/countries/{country_code}.md

4. Use

   GET lobsterbrew.com/offers/{country_code}.md

   to prioritize active offers
5. Choose a merchant before using Shopify Storefront MCP

Merchant connect

1. GET

   lobsterbrew.com/merchants/{slug}/connect.md

2. Read the returned merchant MCP URL
3. Connect to that merchant's Shopify Storefront MCP
4. Use that merchant MCP for:
   • catalog search
   • product details and availability
   • policy questions
   • cart retrieval
   • cart updates
   • checkout URL generation

Do not infer merchant MCP URLs yourself when a connect response is available.

Prefer the

.md

endpoints for agent consumption. Use the JSON endpoints only when a structured machine response is required.

Treat merchant MCP data as the source of truth for products, pricing, availability, cart state, and checkout URLs.

Subscription products

When the merchant MCP exposes subscription choices, inspect subscription fields before updating the cart.

1. Check for:

   • requiresSellingPlan

     or

     requires_selling_plan

   • variant-level selling plan requirements

   • sellingPlanGroups

   • sellingPlanAllocations

   • available

     sellingPlanId

     values
2. If a subscription is optional, present both one-time and subscription choices.
3. If a selling plan is required, do not attempt a normal cart add without a

   sellingPlanId

   .
4. Ask the owner to choose a cadence unless a clear preference already exists in local memory.
5. Highlight subscription savings when

   priceAdjustments

   ,

   price

   , or

   compareAtPrice

   show the subscription is cheaper than the one-time purchase.
6. Try the merchant MCP cart and checkout flow first.
7. If the merchant MCP cannot apply the required selling plan, tell the owner that this merchant flow is not supported yet.

Cart rule

When updating carts, attach private cart attribute only if the merchant MCP supports cart attributes cleanly:

• lb_source__ = lobsterbrew

Otherwise omit the attribute instead of assuming support.

Final handoff

When you finish, return a structured summary with:

• merchant

• product

• variant

• purchase_type

• selling_plan_name

• selling_plan_id

• cadence

• savings_summary

• checkout_url

• resolution_path

Use

resolution_path = mcp_cart

when merchant MCP created the cart. Use

resolution_path = unsupported_subscription_flow

when a required selling plan could not be applied through the merchant MCP.

Say clearly when:

• the item is subscription-only
• the available cadences are every 1, 2, or 4 weeks, monthly, or similar
• the subscription saves money versus one-time purchase
• the merchant MCP could not attach the required selling plan and the flow is not supported yet

Safety

• This skill is for merchant discovery and Shopify Storefront MCP routing, not product truth storage
• Keep preferences and prior purchases in your own local memory
• Do not attempt payment completion
• Return checkout URL to owner for approval and payment
• Do not infer merchant MCP URLs yourself when a connect response is available