# Gaia suite for AI assistants

> Markdown version of https://www.gaiasuite.com/mcp. The Gaia suite app for ChatGPT, Claude and Gemini: what it does, how to connect it, and how it handles data.

Ask ChatGPT, Claude or Gemini about your catalogue, stock and sales

The Gaia suite app connects your assistant to your live Gaia data: products, stock, orders, revenue, returns and invoices, across your own stores and marketplaces. For Gaia customers, with your Gaia account.

- Server URL: `https://mcp.gaiasuite.com`
- Remote MCP server · Streamable HTTP · OAuth with your Gaia account
- Included in your Gaia plan
- Read-only
- Set up in two minutes

## Illustrative example, fictional brand

> Which SS26 products have stock but no sales in the last 30 days?

SS26 · in stock, no sales in 30 days

Brand: Maison Exemple

| Product | SKU | Stock | Stock value |
|---|---|---|---|
| Linen overshirt · Sand | MEX-SS26-0142 | 86 | €7,654 |
| Pleated midi skirt · Ink | MEX-SS26-0217 | 54 | €5,346 |
| Raffia tote · Natural | MEX-SS26-0388 | 41 | €2,829 |
| Striped knit polo · Navy | MEX-SS26-0095 | 37 | €2,183 |

Four SS26 products have had no sales in 30 days: 218 units and €18,012 of stock at cost. The linen overshirt ties up the most.

## Your commerce data, one question away.

Ask in your own words, in English or French. Your assistant picks the right tool and answers from your live Gaia data.

- **Find what isn't selling.** Dead stock and slow sellers by season, brand or category, with the stock value they tie up.
  - Which SS26 products have stock but no sales this month?
- **Follow sales by channel.** Revenue, units and margin for each of your stores and marketplaces, for any period.
  - Revenue and margin by channel for October
- **Handle returns and service.** Return reasons, the most-returned products, and where an order stands with its carrier.
  - What are our top return reasons on Zalando this season?
  - Where is order GAIA-10001 and who is the carrier?

## Connected in three steps.

1. **Add the app.** Add Gaia suite in your assistant's connector settings. Two minutes, no API key.
2. **Sign in with your Gaia account.** Your usual Gaia login and 2FA. Work for several companies? Each one connects with its own URL.
3. **Ask in your own words.** In English or French. Answers come from your live data, with links back to your Gaia back office.

## Set up and reference.

For users, company admins and directory reviewers.

## Set it up

Choose your assistant.

### Claude

In Claude on the web or the desktop app, open **Customize → Connectors**.

Choose **+ Add → Add custom connector**, name it **Gaia suite** and paste the server URL:

```
https://mcp.gaiasuite.com
```

Choose **Continue**, then sign in with your Gaia account.

On a Team or Enterprise plan, an owner adds the connector first, in **Organization settings → Connectors**; each member then chooses **Connect** and signs in with their own Gaia account. Once Gaia suite is listed, find it in the **Discover** tab of Connectors instead.

### ChatGPT

Once Gaia suite is listed, find it in the ChatGPT plugin directory and connect it.

Until then: open **Plugins**, choose **+**, then **Add custom MCP server**. Name it **Gaia suite** and enter the server URL:

```
https://mcp.gaiasuite.com
```

Set authentication to **OAuth**, choose **Create as a plugin** and sign in with your Gaia account.

On a Business or Enterprise workspace, an admin or owner adds the plugin for the workspace.

### Gemini

Once Gaia suite is listed, connect it from **Settings → Connected Apps** in Gemini.

Until then: in Gemini on the web, open **Settings → Connected Apps**, choose **Add a custom app** and enter the server URL:

```
https://mcp.gaiasuite.com
```

Choose **Next**, sign in with your Gaia account, then type **@** in a chat to use the app.

Google limits custom apps to personal Google accounts, in some countries and languages only. Check the Gemini help pages for where they are available.

### Claude Code

Add the server from your terminal:

```
claude mcp add --transport http gaia-suite https://mcp.gaiasuite.com
```

Then run `/mcp` in Claude Code and sign in with your Gaia account.

### Other clients

Any remote MCP client that supports OAuth 2.0 with dynamic client registration over Streamable HTTP can connect. Point it at the server URL:

```
https://mcp.gaiasuite.com
```

### Several companies?

The app opens your first company. To connect another one, add a separate connector with `https://mcp.gaiasuite.com/<company-slug>`. The slug is the start of your Gaia address, `<slug>.gaiasuite.com`.

## What it can do

31 read-only tools. Your assistant picks the right one.

### Catalogue

Products and their variants, attributes, brands, categories and tags.

Tools: `get_products`, `get_product_attributes`, `get_product_attribute_values`, `get_brands`, `get_categories`, `get_tags`.

List our SS26 knitwear with its colours and sizes

### Stock

Stock by product and location, stock movements, and your warehouses and stores.

Tools: `get_stocks`, `get_stocks_movements`, `get_locations`.

How much stock do we hold in each warehouse?

### Sales and revenue

Revenue, units and margin by period, channel and product.

Tools: `get_revenues`, `get_product_revenues`.

What were our ten best sellers last month?

### Orders and customers

Orders with their lines, status and shipping, your customers, and the notes on orders and returns.

Tools: `get_orders`, `get_customers`, `get_annotations`.

Where is order GAIA-10001 and who is the carrier?

### Returns

Return reasons and rates, returned orders and return authorisations (RMAs).

Tools: `get_returns_report`, `get_returns`, `get_rmas`.

Which products are returned most this season, and why?

### Invoices and credit notes

The invoices and credit notes issued for your orders.

Tools: `get_proformas`.

Show the credit notes for order GAIA-10001

### Channels and pricing

Your sales channels, where each product is live, pricing rules, and the history of prices, promotional prices and RRPs.

Tools: `get_channels`, `get_product_activations`, `get_product_activation_history`, `get_pricing_rules`, `get_product_price_history`, `get_product_promotional_price_history`, `get_product_rrp_history`.

Which products aren't live on Zalando yet?

### Reference data

Your company settings, countries, currencies, exchange rates, languages and VAT rates.

Tools: `get_company`, `get_countries`, `get_currencies`, `get_exchange_rates`, `get_languages`, `get_vat_rates`.

What VAT rate applies to our sales in Germany?

The app reads your data; it never changes products, prices, orders or stock.

## What you get back

In ChatGPT and Claude, product lists, revenue tables and order details show as interactive cards, with links that open the page in your Gaia back office. Other clients get the same figures as text. Amounts are in your company currency.

## Your data

- **What the assistant receives.** The data you ask about, from your company's Gaia account. It can include end-customer order details such as names, contact and delivery data. The assistant provider you or your company chose (OpenAI, Anthropic or Google) processes it under its own terms.
- **What Gaia never sees.** Your conversations, your files or your assistant account.
- **What Gaia logs.** The tool called, its parameters, your company and user, whether it succeeded and how long it took, to run and secure the service. Retention: to confirm.
- **Who can connect.** Only users of your company's Gaia account, with the same permissions and 2FA rules as the back office. Data never crosses companies.

The details, and your rights, are in our privacy policy, under [AI assistant integrations (MCP)](https://www.gaiasuite.com/privacy#ai-assistant-integrations).

## Disconnect

- To disconnect, remove Gaia suite from your assistant's connector settings.
- To end every session at once, change your Gaia password.
- Company admins: block or remove a user in the Gaia back office, and their assistant access ends with it.

## Troubleshooting

- **"Sign in again" right after connecting.** Your account uses 2FA. Sign in again with the code from your authenticator app.
- **Asked to sign in again later.** Your session ended: your password changed, your account was blocked or 2FA was turned on. Reconnect the app.
- **Answers are about the wrong company.** You belong to several companies. Add a connector with your company URL (see Set it up).
- **Can't add a custom connector in Claude.** On a Team or Enterprise plan, an owner adds it first.
- **A tool you use in Gaia isn't there.** Some features are in the Gaia Assistant inside the back office only.
- **A figure looks wrong.** Write to support with the question you asked and the time you asked it.

A question about the app, or a figure that looks wrong? Write to [support@gaiasuite.com](mailto:support@gaiasuite.com?subject=Gaia%20suite%20app). For your data, write to [dpo@gaiasuite.com](mailto:dpo@gaiasuite.com).

## FAQ

### What is an MCP server?

MCP, the Model Context Protocol, is an open standard that lets AI assistants call outside tools. The Gaia suite MCP server gives your assistant read access to your company's Gaia data, through the tools listed on this page.

### Who can use it?

Gaia customers. You sign in with your Gaia account and see the same data as in the back office.

### Does it cost extra?

No. The app is included in your Gaia plan.

### Which assistants does it work with?

Claude, ChatGPT and Gemini, Claude Code, and any remote MCP client that supports OAuth 2.0 over Streamable HTTP.

### Can it change my data?

No. Every tool is read-only: the app never changes products, prices, orders or stock.

### Is my customers' data sent to the assistant?

Yes, when you ask about it. An order lookup can return the customer's name, contact and delivery details, which your assistant provider then processes under its own terms. See Your data on this page.

### How do I disconnect?

Remove Gaia suite from your assistant's connector settings. To end every session at once, change your Gaia password.

## Not a Gaia customer yet?

[Book a demo](https://www.gaiasuite.com/book-a-demo) · [Add the app](https://www.gaiasuite.com/mcp#setup)
