# Agentic Playbooks: Plays you can run with the Hello Retail MCP

> A library of agentic ecommerce plays: what shops and the Hello Retail team asked their AI assistant, which Hello Retail MCP tools it used, and what changed. Each play reads "How [who] used [feature] to [outcome]".

- **Index**: https://helloretail.com/en/agentic-playbooks/
- **Plays**: 4
- **MCP setup guide**: https://helloretail.com/en/mcp/#connect

Every MCP tool that edits something asks for permission first. Changes to things like a search design land in a draft, and the audit log records every change made through the MCP server.

# Real examples, step by step

## How our product team used the Hello Retail MCP to turn the monthly report into one prompt

- **Result**: A report split by solution, ending in a to-do list, on the first of every month
- **Products**: Search, Product Recommendations, Pages, Product Agents
- **Page**: https://helloretail.com/en/agentic-playbooks/monthly-performance-report/
- **Full play (markdown)**: https://helloretail.com/en/agentic-playbooks/monthly-performance-report.md

```text
Please create a performance report for the months August and September, separating out numbers for Search, Recommendations, Pages, and Product Agents.
```

## How our product team used Search MCP tools to fix searches that found nothing

- **Result**: 11 synonym entries across nine searches, after one yes
- **Products**: Search
- **Page**: https://helloretail.com/en/agentic-playbooks/zero-result-searches-synonyms/
- **Full play (markdown)**: https://helloretail.com/en/agentic-playbooks/zero-result-searches-synonyms.md

```text
Please show me all searches that came out with zero results, and tell me where it would make sense to create synonyms for things that we actually sell.
```

## How our product team used Product Intelligence to pick products for the Q4 newsletter

- **Result**: Products ranked by how much of their yearly sales fall in Q4
- **Products**: Product Intelligence, Newsletter Content
- **Page**: https://helloretail.com/en/agentic-playbooks/q4-newsletter-product-intelligence/
- **Full play (markdown)**: https://helloretail.com/en/agentic-playbooks/q4-newsletter-product-intelligence.md

```text
I am currently working on our Q4 newsletter. Please show me a few of my products that would work well in this newsletter based on their Product Intelligence data.
```

## How our product team used the search design tools to dress search up for Halloween

- **Result**: A campaign graphic in the results and orange sale badges, as a draft
- **Products**: Search
- **Page**: https://helloretail.com/en/agentic-playbooks/halloween-search-design/
- **Full play (markdown)**: https://helloretail.com/en/agentic-playbooks/halloween-search-design.md

```text
Let's adjust our search template to reflect our Halloween campaign.
```

# The library

## Search

Find what shoppers miss, tune the ranking, and change the look, all in words.

### Fix the searches that find nothing

```text
Which searches returned zero results last month, and which of those products do we actually sell?
```

Pulls zero-result queries, checks the catalog for each, proposes synonyms for the ones that exist and flags true catalog gaps. Approve the good ones and they go live after the next reindex. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/search/fix-the-searches-that-find-nothing/

### Monday-morning synonym review

```text
Every Monday at 08:00, show me new zero-result searches from last week with suggested synonyms.
```

A scheduled task that puts suggestions in front of the merchandiser before the week starts. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/search/monday-morning-synonym-review/

### Curate a hot query

```text
When people search for 'rain jacket', show our bestselling rain jacket first.
```

Finds the product, adds a query rule that elevates it. Works for one query or across all queries. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/curate-a-hot-query/

### Spot the surging search

```text
Which searches grew the most this month compared to last?
```

Sorts top searches by increase, so a sudden trend gets a query rule or a front-of-search panel before the demand passes. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/spot-the-surging-search/

### Boost our own brand

```text
Push our private label higher in search results.
```

Reads current boosts, finds the exact brand value as indexed, adds the boost. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/boost-our-own-brand/

### Test a ranking change without touching live traffic

```text
Create a copy of our search engine, boost 'new in' products, and put it on a test config so I can compare.
```

Creates a second product engine, tunes it, attaches it to a non-live config. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/test-a-ranking-change-without-touching-live-traffic/

### Filters shoppers actually use

```text
Which filters and sort options do people use, and which ones are we missing?
```

Compares filter and sort usage with the current configuration, makes a missing field filterable and drops dead ones. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/filters-shoppers-actually-use/

### Something useful before people type

```text
Show our Tuesday bestsellers in the search box before anyone types.
```

Combines Product Intelligence day-of-week ranking with the initial-content panels. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/something-useful-before-people-type/

### Monthly search check-in

```text
How is search doing this month versus last? Revenue, conversion, top searches.
```

One prompt replaces a dashboard session. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/monthly-search-check-in/

### Hide a product for a specific query

```text
Don't show the kids' version when people search for 'running shoes'.
```

Adds an exclude on the engine. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/hide-a-product-for-a-specific-query/

### Stop words

```text
'Shoes for kids' works but 'shoes for the kids' doesn't.
```

Adds filler words so phrasing stops mattering. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/stop-words/

### Personalized ranking per visitor

```text
Start ranking search results by the brands each visitor prefers, gently.
```

Turns on personalization on one field with a low boost, then checks analytics after a few weeks. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/personalized-ranking-per-visitor/

### Categories and blog posts in search

```text
Show our guides and categories in search results, not only products.
```

Adds content panels and tunes the content engine. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/categories-and-blog-posts-in-search/

### Seasonal search design

```text
Adjust our search template to reflect our Halloween campaign: Add this graphic in the corner, linked to the campaign page.
```

A design change described in words, saved as a draft to preview before publishing. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/search/seasonal-search-design/

### Clean up after a campaign

```text
The brand campaign is over. Remove the boost and the query rule we added for it.
```

Finds the rules and removes or lowers them. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/clean-up-after-a-campaign/

### Why does our own frontend get no results?

```text
Search returns nothing on our headless frontend.
```

Checks whether the config is actually live and not still in review. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/search/why-does-our-own-frontend-get-no-results/

### Zero-result audit across markets

```text
Do the zero-result review for our .dk, .se and .de shops in one go.
```

Same workflow across websites and languages in one session. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/search/zero-result-audit-across-markets/

### Search-driven orders

```text
Which orders did search drive last week, and what did those shoppers search for?
```

Ties search to revenue in a way you can forward to your boss. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/search/search-driven-orders/

## Recommendations

Find the weak boxes, fix them, and restyle every box at once.

### Find the weakest box and fix it

```text
Which recommendation box is underperforming and what should we change?
```

Ranks boxes by click-through or conversion, checks if it was always weak or recently dropped, applies the best-practice algorithm for that box type. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/find-the-weakest-box-and-fix-it/

### A box disappeared

```text
Our 'bought together' box is gone from the product page since the redesign.
```

Reads the placement selector, turns on API logging, tells you whether the script isn't firing or the algorithm returns nothing, updates the selector. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/a-box-disappeared/

### Give every box the new look

```text
Apply our new design to all recommendation boxes, but keep the old one serving until I've checked.
```

Copies the design, edits the copy, swaps all boxes in one call. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/give-every-box-the-new-look/

### Recommendations on a new landing page

```text
Add a recommendation slider to our new outdoor landing page.
```

Creates a draft box with a best-practice algorithm and the right placement. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/recommendations-on-a-new-landing-page/

### Overall recommendations health

```text
How are recommendations doing overall? Top ten by revenue and the ten that earn nothing.
```

The whole picture in one answer. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/overall-recommendations-health/

### Explain a box in plain words

```text
What is the 'You might also like' box on the basket page actually set up to do?
```

Translates the algorithm steps into your own words instead of JSON. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/explain-a-box-in-plain-words/

### Hand-tune a strategy

```text
On the product page box, show same-brand alternatives first, then bought-together, and never show out of stock.
```

Edits the algorithm steps with full context. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/hand-tune-a-strategy/

### Track clicks in Google Analytics

```text
Send recommendation clicks to GA4 with event category 'recoms'.
```

Analytics settings changed by asking. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/track-clicks-in-google-analytics/

### Before and after a change

```text
We changed the home page box two weeks ago. Compare performance before and after.
```

Daily analytics around the change date, paired with the audit log entry. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/before-and-after-a-change/

### Copy a setup to a new site

```text
Set up the same boxes on our new .no site as we have on .dk.
```

One shop's setup, rolled out to the next. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/recommendations/copy-a-setup-to-a-new-site/

## Pages

Category and landing pages, built, pinned and restyled by asking.

### Why does this category convert badly?

```text
Our 'Women's jackets' page converts badly. Why?
```

Ranks pages by conversion, breaks down by URL, checks filters and boosts, lifts what Product Intelligence says sells. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/why-does-this-category-convert-badly/

### Pin products on the sale page

```text
Show these five products first on the sale page this week.
```

A URL override, created as a draft. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/pin-products-on-the-sale-page/

### Build a campaign page

```text
Build a page for our summer campaign with everything from the Summer collection, bestsellers first.
```

A new page from one prompt. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/build-a-campaign-page/

### Monthly pages report

```text
How are our pages doing this month, and which are the winners?
```

The winners and the laggards, side by side. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/monthly-pages-report/

### New look for all category pages

```text
Give our category pages the new look; keep the old design serving until I publish.
```

The redesign waits in a draft until you publish. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/new-look-for-all-category-pages/

### Add a filter

```text
Let shoppers filter category pages by brand and material.
```

Checks field indexing, updates the design filters. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/add-a-filter/

### Clone a page

```text
Set up the same page for the Kids category.
```

A finished page, copied. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/pages/clone-a-page/

### Seasonal reorder of category pages

```text
It's October. Reorder the Outdoor category to put products that peak in Q4 first.
```

Product Intelligence seasonality applied as boosts. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/pages/seasonal-reorder-of-category-pages/

## Product Intelligence

What to promote, when, and at what price, from how your products actually sell.

### What to promote this weekend

```text
What should we promote this weekend?
```

Day-of-week ranking from Product Intelligence, then pushed into search, pages or newsletter. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/what-to-promote-this-weekend/

### Best products for a given time of day

```text
Which products sell best on Thursday evenings? I'm planning a 20:00 push notification.
```

The right products for the moment the message lands. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/best-products-for-a-given-time-of-day/

### Seasonal picks

```text
Which products sell a large share of their yearly volume in December?
```

Seasonality ranking, distinct from plain bestsellers. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/seasonal-picks/

### Q4 newsletter candidates

```text
I'm working on our Q4 newsletter. Show me products that over-index in Q4 based on Product Intelligence.
```

Products ranked by how much of their yearly sales fall in Q4. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/q4-newsletter-candidates/

### Which products to discount, and which never to

```text
Which products are most likely to sell at 15% off, and which sell fine at full price so we should leave them alone?
```

Discount ranking, plus the full-price winners to leave alone. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/which-products-to-discount-and-which-never-to/

### Voucher candidates

```text
Which products are the best candidates for a 15% voucher on the website?
```

A voucher that moves the products it is meant to. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/voucher-candidates/

### Promotion calendar

```text
Build a promotion calendar for next week: The three best sellers for each day.
```

Next week planned in one answer. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/promotion-calendar/

### Loyalty products

```text
Which products bring the most lifetime value, and which get repurchased most?
```

Lifetime value, retention and recurrence rankings. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/loyalty-products/

### Full-price repurchase heroes

```text
Most repurchased products that mostly sell at full price.
```

One dimension ranks, another gates. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/full-price-repurchase-heroes/

### Stock planning ahead of a season

```text
We're placing the Christmas order in August. Which products peaked last December and should be stocked deeper?
```

Last season informs the next order. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/stock-planning-ahead-of-a-season/

### Black Friday shortlist

```text
Which products sell well on Black Friday with a 10 to 20% discount?
```

A shortlist built on behaviour, not gut feeling. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-intelligence/black-friday-shortlist/

## Newsletter Content

Product tiles, picks and campaigns for the email you already send.

### Design newsletter tiles

```text
Design product tiles for our newsletter that match our shop.
```

Reads what the renderer supports, starts from a template, renders against real products, iterates on the images. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/design-newsletter-tiles/

### Change the tile design safely

```text
Change the tile design our newsletters use, without breaking the mails already in inboxes.
```

Copies the design and edits the copy. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/change-the-tile-design-safely/

### Which newsletters and products actually sell

```text
Which newsletters and products earned the most last quarter?
```

Then pins the winning products on the next manual campaign. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/which-newsletters-and-products-actually-sell/

### Next week's newsletter products

```text
Which products go into next week's newsletter, and what would a known versus unknown recipient see?
```

Previews both. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/next-weeks-newsletter-products/

### Set up a campaign for your email platform

```text
Set up a Newsletter Content campaign for our Klaviyo newsletter.
```

Picks Auto, Rolling or Manual based on the platform. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/set-up-a-campaign-for-your-email-platform/

### Recipients still see old products

```text
We fixed the campaign but recipients still get the old products.
```

Clears locked products so the next open picks fresh ones. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/recipients-still-see-old-products/

### Is our auto campaign actually sending?

```text
Is our auto campaign going out?
```

A straight answer instead of a support ticket. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/is-our-auto-campaign-actually-sending/

### Is personalization paying off?

```text
Is personalizing the newsletter paying off?
```

Known versus unknown recipients, and the identified-visitor ceiling. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/is-personalization-paying-off/

### Product picks for a themed send

```text
Give me ten products for a 'back to school' newsletter, ranked by August seasonality, with image, price and link.
```

Output ready to paste into any email platform. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/newsletter/product-picks-for-a-themed-send/

## Product Agents

Switch agents on, set their limits, and give them your voice.

### Turn on an agent with limits

```text
Start emailing customers about price drops, but only for our own brand.
```

Reads channels and settings, enables the agent with product filters and a custom prompt. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-agents/turn-on-an-agent-with-limits/

### Make agent emails sound like us

```text
Make the agent emails sound more like us: Shorter, warmer, no exclamation marks.
```

Updates tone of voice, sends a test. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-agents/make-agent-emails-sound-like-us/

### Agent performance

```text
How are our Product Agents doing this month? Messages, revenue per message, by agent.
```

Every agent, one answer. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-agents/agent-performance/

## Retail Media

Sponsored placements set up, checked and reported on by asking.

### What's running and is it working?

```text
Which sponsored campaigns are running, and are they working?
```

Spend against clicks and orders per campaign. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/retail-media/whats-running-and-is-it-working/

### Set up a sponsored placement for a brand

```text
Set up a sponsored placement for this brand with these products and a 5.000 kr budget.
```

Created in review; you set it live. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/retail-media/set-up-a-sponsored-placement-for-a-brand/

### Banner campaign from a brief

```text
Create a banner campaign for the spring promotion, one image per placement size.
```

From brief to campaign in one step. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/retail-media/banner-campaign-from-a-brief/

## Product data and feeds

Troubleshoot prices, feeds and fields without opening a ticket.

### Wrong price on a product

```text
Why does this product show the wrong price?
```

What Hello Retail holds, when it changed and from which source, whether the feed run failed. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-data/wrong-price-on-a-product/

### Did last night's feed run go wrong?

```text
Did last night's feed run go wrong?
```

Outcome, rejected items, a spike in deletions. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-data/did-last-nights-feed-run-go-wrong/

### Connect a product feed

```text
Connect our product feed: Here is the URL.
```

Creates the feed, reads the first run, fixes the mapping until clean. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-data/connect-a-product-feed/

### Is this product indexed, and with what data?

```text
Is SKU 48213 indexed, and what price, stock and categories does it have?
```

One product, every field. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-data/is-this-product-indexed-and-with-what-data/

### Which fields can we filter and sort on?

```text
Which product fields are searchable and sortable right now?
```

The current setup, in a list. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/product-data/which-fields-can-we-filter-and-sort-on/

### Make a feed field usable

```text
Our feed has a 'material' field. Make it filterable in search and on category pages.
```

From raw feed field to shopper filter. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-data/make-a-feed-field-usable/

### What changed on this product and when

```text
Show me the change history for this product over the last month.
```

Every change, dated. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/product-data/what-changed-on-this-product-and-when/

## Reporting and monitoring

The reports you build by hand, built and scheduled by one prompt.

### Monthly performance report

```text
Create a performance report for August and September, split by Search, Recommendations, Pages and Product Agents.
```

One report across every solution, with top searches, shopper paths and a prioritised to-do list. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/reporting/monthly-performance-report/

### Scheduled monthly report

```text
Run this report on the first of every month for the two previous months.
```

A recurring task in Claude Cowork or similar. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/reporting/scheduled-monthly-report/

### Anomaly check

```text
Did anything drop sharply in the last seven days across search, recoms or pages? If so, what changed in the configuration around that date?
```

Pairs daily analytics with the audit log. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/reporting/anomaly-check/

### Who changed this, and when?

```text
Who changed the search configuration last week?
```

Audit log filtered to the resource. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/reporting/who-changed-this-and-when/

### Failed API calls

```text
Show me the failed API calls from the last day.
```

The integration check, without a developer. (In the MCP guide)

Page: https://helloretail.com/en/agentic-playbooks/reporting/failed-api-calls/

## Design and frontend

Change how things look by describing it.

### Search overlay changes in words

```text
Make the search box more prominent and move the filters to the left.
```

A design brief, carried out. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/design/search-overlay-changes-in-words/

### Recolour the sale badge

```text
Give the sale badge a seasonal look across search, recommendations and pages.
```

One change, every surface. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/design/recolour-the-sale-badge/

### Preview before publishing

```text
Show me what the draft search design looks like before I publish it.
```

See it on your shop before shoppers do. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/design/preview-before-publishing/

## Across your other tools

Hello Retail together with your shop platform, email and spreadsheets in one chat.

### Black Friday in one chat

```text
Find products that sell well at 10 to 20% off around Black Friday, lower their prices in Shopify, boost them in search, and give the sale badge a Black Friday look.
```

Hello Retail MCP plus the Shopify MCP. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/cross-platform/black-friday-in-one-chat/

### Discount and reprice

```text
Which products sell well at a discount? Lower their price in Shopify by 15%.
```

Insight and action in the same request. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/cross-platform/discount-and-reprice/

### Newsletter to Klaviyo

```text
Pick the products for Friday's newsletter and create the Klaviyo campaign draft.
```

From picks to a campaign draft. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/cross-platform/newsletter-to-klaviyo/

### Multi-domain rollout

```text
Apply these changes to .se and .dk, and copy the search setup from .dk to the new .fi site.
```

Every market in one session. (On helloretail.com)

Page: https://helloretail.com/en/agentic-playbooks/cross-platform/multi-domain-rollout/
