# Hello Retail

> Hello Retail is an MCP server for e-commerce. MCP server letting AI assistants run Hello Retail ecommerce search, recommendations. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://developer.helloretail.com/mcp
- **MCP Registry name:** com.helloretail/hello-retail
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

The Hello Retail MCP server lets assistants such as Claude, OpenAI Codex and ChatGPT call Hello Retail's commerce APIs as tools, so store teams can ask for changes in plain language instead of working through the dashboard. The registry entry covers search, recommendations, page design, newsletter content, product agents and analytics.

Tools are grouped as read-only, write, or destructive write. The documentation says nothing publishes automatically: edits to search configs, Recommendations boxes and Pages land in a draft that someone must push live from My Hello Retail. Search engine changes and newsletter campaign edits are an exception and go live as soon as they are saved, so the docs recommend reading current values first.

The server is aimed at ecommerce teams and developers who already use Hello Retail and want to investigate catalog problems, such as searches that return nothing, or manage synonyms and feeds from an assistant. Access requires a company ID and OAuth login on first use.

## Features

- **Assistant tool access:** Exposes Hello Retail APIs as MCP tools that Claude, Codex and ChatGPT can call.
- **Search configuration tools:** Covers search engines, synonyms, stop words and redirects for ecommerce search.
- **Draft-based publishing:** Most page and search config edits stay in a draft until a user publishes them in My Hello Retail.
- **Read-only and write classification:** Each tool is marked read-only, write or destructive so clients can gate confirmations.
- **Search analytics queries:** Lets assistants pull analytics such as top searches that return no results.
- **Newsletter content tools:** Provides tools to read, preview and update newsletter designs and campaigns.

## Good for

- Finding top site searches that return no results and adding synonyms for them
- Checking catalog data fields and re-indexing product content after edits
- Reviewing and adjusting Recommendations boxes or Page designs in draft
- Previewing newsletter campaign changes before saving them

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hello-retail https://core.helloretail.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://core.helloretail.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hello-retail": {
      "url": "https://core.helloretail.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hello-retail": {
      "type": "http",
      "url": "https://core.helloretail.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hello-retail": {
      "serverUrl": "https://core.helloretail.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://core.helloretail.com/mcp
```

Enter a Name (for example "Hello Retail"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hello-retail": {
      "type": "http",
      "url": "https://core.helloretail.com/mcp"
    }
  }
}
```

## FAQ

### How do I connect to the server?

The docs say the assistant handles OAuth login on first use and reuses the token until it expires. You need your company ID to list websites.

### Do MCP tools publish changes to my live site?

No. The docs say no MCP tool publishes; search config, Recommendations and Page changes land in a draft that you push live yourself from My Hello Retail.

### Are there tools that take effect immediately?

Yes. Search engine changes, newsletter campaign edits, synonym changes, feed creation and indexing field updates take effect immediately or on the next re-index, and have no undo.

### How do I add Hello Retail to Claude Code?

Run this command in your terminal: claude mcp add --transport http hello-retail https://core.helloretail.com/mcp

### What are the best alternatives to Hello Retail?

The closest alternatives to Hello Retail are CommerCentr E-commerce Catalog MCP Server, MCP, 1stPage — Amazon Seller & Vendor Analytics, Site and Trendyol Seller MCP.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [CommerCentr E-commerce Catalog MCP Server](https://ai-powered.com/mcp/commercentr-e-commerce-catalog-mcp-server): CommerCentr E-commerce Catalog MCP Server is a freemium MCP server for e-commerce.
- [MCP](https://ai-powered.com/mcp/mcp-mwencx2v): MCP is an MCP server for analytics and data.
- [1stPage — Amazon Seller & Vendor Analytics](https://ai-powered.com/mcp/1stpage-amazon-seller-and-vendor-analytics): 1stPage — Amazon Seller & Vendor Analytics is a freemium MCP server for marketing and seo.
- [Site](https://ai-powered.com/mcp/site-mwesc3xu): Site is an MCP server for e-commerce.
- [Trendyol Seller MCP](https://ai-powered.com/mcp/trendyol-seller-mcp): Trendyol Seller MCP is an open-source MCP server for e-commerce.
- [MCP Ecommerce](https://ai-powered.com/mcp/mcp-ecommerce): MCP Ecommerce is a free MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/hello-retail
