The bluebarry MCP server lets AI assistants such as Claude and ChatGPT work in your store: read your setup, catalog and performance, build and edit quizzes, search, popups, collection pages and recommendations, preview them, and publish what you confirm.
Connect
MCP server URL
https://mcp.bluebarry.ai/mcpAdd this URL as a custom connector in your AI client. The client registers itself and opens a bluebarry sign-in, where you can also create an account. You do not need an API key. Step by step: Claude or ChatGPT.
What an assistant may do
You choose this in Studio under Settings, AI assistants. The client asks for the same level when you connect.
- Read only (
bluebarry.read): reads and previews, changes nothing. - Create and edit (
bluebarry.write): also creates drafts and edits your store. Every change is recorded and most can be undone. - Create, edit and publish (
bluebarry.publish): also publishes and switches things live, each time after you confirm what changes for shoppers.
Tool reference
You rarely call tools by name. Ask in plain words and the assistant picks the right tool.
| Tool | What it does |
|---|---|
get_store_overview | What your store runs, how far each part is set up, the next setup step, your brand profile, your standing instructions and what this connection may do. Usually the first call. |
get_guide | bluebarry's guidance for each part of the store, and the fields of everything the create and edit tools take. |
list_entities, get_entity | Your quizzes, search profiles, popups, collection pages, recommendation blocks and other items, and one item in full. |
query_analytics | Performance reports: quizzes, search and searches without results, recommendations, popups, product chat and the whole store's orders, bestsellers and products bought together. |
search_products, get_catalog_schema | Products in your catalog, and the attributes and values bluebarry matches on. |
query_profiles, preview_segment | Shopper profiles and audience sizes, without email addresses. |
query_change_history | What changed in your store, by whom, and whether it can be undone. |
diagnose_search | How a search term was read and why each product shows or is missing. |
evaluate_answers | Which products each quiz answer leads to. |
get_translations | An item's texts per language. |
query_live_product_feed | What a live product feed imports. |
preview_recommendation_block | The products a recommendation block shows. |
render_previews | Screenshots of a quiz, popup, search page or collection page on mobile and desktop. |
check_storefront | What of bluebarry shows on your store. On Shopify: whether the bluebarry app embed is on and where each widget shows in your theme. On WooCommerce and Magento: where widgets are placed. Elsewhere: the Studio page that places them. |
| Tool | What it does |
|---|---|
create_quiz, edit_quiz | Builds a quiz from a description, on your real catalog, as a draft, and changes its questions, answers, filters, result cards and design. |
create_search_setup, edit_search_setup | Adds and changes synonyms, redirects, banners, merchandising rules and search settings. These apply to your live search right away. |
create_popup, edit_popup | Designs a popup in your brand's look as a draft, and changes its screens, fields and trigger. |
create_collection_page, edit_collection_page | Builds a collection page template for your Shopify collections as a draft, and changes its sections. |
create_recommendation_block, edit_recommendations | Adds and changes recommendation blocks such as frequently bought together. Live blocks change right away. |
create_catalog_item, edit_catalog | Adds and changes product attributes and their values, and live product feed filters and mappings. |
edit_storefront_styles | Changes the custom CSS of the search box and results page on your store. |
duplicate | Copies an item as a new draft. |
undo_changes | Restores the values a recorded change overwrote. |
publish | Publishes a quiz, popup, collection page or search results page, or takes one down, after you confirm. |
Questions to try
- "Look at my store and suggest the first thing to set up."
- "Which question in my skincare quiz loses the most people? Fix it."
- "What do people search for that returns no results? Add synonyms for the obvious ones."
- "Build a popup that offers 10% off a first order and show me a mobile preview."
Good to know
- An assistant can delete a part of something, such as a quiz question or a search synonym, after you confirm. Deleting a whole quiz, popup or page, and your billing, team, API key and integration settings, stay in Studio.
- Shopper email addresses are never shared with an assistant.
- Your standing instructions under Settings, AI assistants apply to every assistant you connect.
- Disconnect an assistant there whenever you want to stop its access.