EN
Connect your AI agent

Add Hello Retail to your AI assistant

For Hello Retail customers: Copy the address and add it as a connector in Claude, ChatGPT or Codex.

MCP address

https://core.helloretail.com/mcp

Not a customer yet?The MCP needs a Hello Retail login. Tell us what you want to build.

Let's talk
Let's talk

Read and write: What your AI tool can change in your store

Tools that look, tools that change, and the steps that keep the decision with you

Published

An AI tool connected to your store has two kinds of tool: Read tools that look, and write tools that change.

Read tools answer questions and leave everything as it was. Write tools are what let you operate the store from a conversation: Add the synonym, reorder the sale page, set up the campaign. The write tools ask before they run, and most of what they change lands in a draft that a person publishes.

This guide covers what each kind is for, where a change goes after you approve it, the few changes that take effect at once, and a short routine for reviewing a change well.

Two kinds of tool, and a third label worth knowing

Read

Fetches data, settings or results. Nothing in the store is different afterwards. Ask freely and as often as you like.

Write

Creates or edits something: A rule, a design, a placement, a campaign. The AI tool states what it will do and waits for your yes.

Destructive write

Removes something, such as a synonym or a search rule. It has its own label so that a removal is always a deliberate choice.

The log

An audit log records changes. You can ask who changed a setting and when, which makes it easy to trace a surprise back to its cause.

The Hello Retail connection has both kinds in most product areas. The counts below are read from the live server.

AreaTools that lookTools that change
Search2428
Recommendations1310
Pages1213
Newsletter Content168
Product Agents32
Retail Media43
Product Intelligence10
Product data and feeds135
Orders10
Operations72

What looking gives you

Looking is where every good change starts. A read request replaces the report you would otherwise open, and it can combine sources in one answer, such as comparing the searches that found nothing with the products you actually stock.

These are requests the connection answers with read tools only:

  • “How is search doing this month compared to last?”Looks only
  • “Search returns nothing on our own frontend”Looks only
  • “How are recommendations doing overall?”Looks only
  • “What is this box actually set up to do?”Looks only
  • “Who changed this, and when?”Looks only

What changing gives you

Write tools turn an answer into an action in the same conversation. You no longer carry a finding from a report to a settings screen. You read what the tool found, decide, and let it make the change.

These requests look first and then change something after your yes:

  • “Which searches find nothing, and can you fix them?”Looks, then changes after your yes
  • “When people search for X, show them this product first”Looks, then changes after your yes
  • “Our category page converts badly - why?”Looks, then changes after your yes
  • “Show these products first on our sale page”Looks, then changes after your yes
  • “Design product tiles for our newsletter”Looks, then changes after your yes

Retail Media works the same way with one extra step. An AI tool can draft product and banner campaigns, and a drafted campaign stays in review until a person makes it live in My Hello Retail.

Where a change lands

No tool on the connection publishes. For every product that has a draft state, an approved change goes into the draft, and you publish it in My Hello Retail when you are satisfied. The exceptions are few and worth knowing by heart.

What you changeWhen shoppers see it
Anything with a draft state, such as a search, recommendation or page designAfter you publish the draft in My Hello Retail
Newsletter ContentOn save, since it has no draft state
Search engines and their query rulesOn save. Boosts can take up to five minutes
Synonyms and field indexingAfter the next re-index
A new product feedIt starts inactive
A Retail Media campaignIt stays in review until a person makes it live

The developer documentation lists the label on every tool.

How to review a change

  • Ask for the plan first. Have the tool list what it intends to change before it changes anything. A plan is quick to correct.
  • Ask why. If a proposal looks odd, ask what it is based on. A good answer points to your own data.
  • Read the confirmation. It names the change. Treat it as the review it is.
  • Check where it landed. Draft, saved, or waiting for a re-index. Ask the tool if you are unsure.
  • Look again later. A week on, ask how the changed search, box or page is doing. The same connection that made the change can measure it.

A good first change is a small one you could have made by hand, such as one synonym for a search that found nothing. It shows you the whole path from request to result in a few minutes.

Frequently asked questions

What is the difference between a read tool and a write tool?

A read tool fetches information and leaves the store exactly as it was. A write tool changes a setting, a design, a campaign or a rule. On the Hello Retail connection every tool is labeled read-only, write or destructive write.

Can my AI tool publish a change to the live store?

For products with a draft state, no. The change lands in the draft and a person publishes it in My Hello Retail. Three kinds of change have no draft step and take effect when saved: Newsletter Content, search engines with their query rules, and changes such as synonyms and field indexing, which reach shoppers after the next re-index.

Does the AI tool ask before it changes something?

Yes. Write tools ask for confirmation before they run. The confirmation states what will change, and that moment is the review step. Read it the way you would read a colleague's proposal before saying yes.

What is a destructive write?

A write that removes something, such as deleting a synonym or a search rule. It carries its own label so that it is never approved by habit. Ask the tool to show what will be removed before you confirm.

Can I see what was changed afterwards?

Yes. The connection includes an audit log, so you can ask who changed a setting and when, and get the answer in the same conversation.

Can the AI tool do more than my own account can?

No. You sign in with your own Hello Retail account and the tool acts with that account's access. There is no separate key that carries wider rights.

See what you can build

Every product area has requests worth trying in the first week.

What you can build, product by product