Hypersonix ProfitGPT Retail Analytics
Hypersonix ProfitGPT Retail Analytics connects Claude and ChatGPT to your company's retail data in Hypersonix. Ask a business question in plain English. The assistant looks up the business rules, queries your own data, and answers with real numbers.
- Server URL:
https://aip-api-gw.hypersonix.ai/v1/reporting_ai/mcp - Sign-in: Your Hypersonix account (OAuth)
- Access: Your company's data only
Before you start
You need:
- A Hypersonix account with access to ProfitGPT. Ask your Hypersonix administrator if you are not sure.
- A Claude plan that supports connectors, or ChatGPT with apps or connectors enabled. On Team and Enterprise plans, an owner or administrator may need to enable the connector for the organization first.
Connect
Claude
- Open Settings → Connectors. Find Hypersonix ProfitGPT Retail Analytics in the directory and select Connect. You can also select Add custom connector and enter the server URL above.
- Sign in with your Hypersonix account when prompted, and approve access.
- In a chat, make sure the connector is enabled in the tools menu, then ask a question.
ChatGPT
- Open Settings → Apps & Connectors. Find Hypersonix ProfitGPT Retail Analytics and select Connect.
- Sign in with your Hypersonix account and approve access.
- In a chat, select the connector from the tools menu, then ask a question.
Disconnect
Remove the connector from the same settings page. This revokes the assistant's access straight away. Your Hypersonix account is not affected.
What you can ask
How did we do last week?
“How did we do last week?” “Compare last week's margin with the same week last year.”
You get revenue, profit and margin, units, transactions, and average order value for the latest complete week. Each figure is compared with the week before and the same week last year, with the dates stated.
Pricing alerts
“What pricing opportunities do I have?” “Which items have a weak margin, and how much revenue is at stake?” “Are we MAP compliant?”
You get alerts from Hypersonix price optimization, including competitor price gaps, weak or strong margins, cost and competitor price changes, MAP compliance, and demand drops. Each alert shows the items, revenue and units at stake, the recommended action, and when it was last updated.
Your own questions
“Top 20 items by revenue in March” “Margin by brand this quarter” “What will run out of stock next week?” “Price history for item 12345” “How many orders were cancelled last month?” “Forecast for next month by category”
The assistant finds the right data, checks the rules for it, writes a query, and answers from the results. Ask for a chart when you want one.
Tips
- Name the period, such as “last 4 weeks” or “March 2026.” Without one, the assistant may ask for clarification, or a very broad request may be refused and narrowed.
- Use the names you know for brands, categories, or stores. If the stored spelling differs, the assistant uses the closest match and tells you which one.
- Ask a follow-up to break a result down, such as “now by store,” or ask for a chart.
Data available
| Dataset | What it holds |
|---|---|
| Sales | Sales transactions: revenue, units, and cost of goods |
| Orders | Order headers, including status (for example, cancelled) |
| Order Lines | Items on each order |
| Price History | Price changes over time |
| Current Price | Each item's latest price |
| Cost | Item costs |
| Inventory | Stock-on-hand snapshots by date |
| Item Master | Item attributes: category, brand, vendor, and your company's custom fields |
| Forecast | Demand forecasts |
| Weekly sales overview | Latest complete week compared with the prior week and last year |
| Pricing alerts | Price optimization alert cards |
What is populated depends on what your company has loaded into Hypersonix. When a field is empty for your data, the assistant says that a breakdown is not available rather than guessing.
Getting accurate answers
Retail data has traps that can produce numbers that look right but are wrong. Examples include cancelled orders counted as revenue, stock added up across several snapshot dates, or joins that repeat every sale once per store. ProfitGPT guards against these:
- Documented rules. The assistant reads rules for each dataset before querying. The rules were measured against real data.
- Automatic checks. Every query is checked against those rules. If it looks likely to give a misleading number, the assistant gets a warning and corrects the query or tells you the caveat.
- Stated limits. The assistant tells you which filters it applied and what the data cannot support.
- Unconfirmed data is flagged. Some datasets are not yet fully confirmed. When an answer uses one, the assistant says so.
Treat figures as you would any report. Check numbers before you act on a material decision.
Security and privacy
- Your company's data only. Your company is set by your Hypersonix login, never by the assistant.
- Your data is never changed. The connector only reads it.
- No model on our side. Hypersonix does not send your data to any AI model. Results go only to the conversation you are in.
- No training, no sharing. Hypersonix does not use your data for training, and does not sell or share it with third parties.
For full details, see the Hypersonix privacy policy. Read the Terms and Conditions.
Troubleshooting
| What you see | What to do |
|---|---|
| “Could not connect” when adding the connector | Check that you entered the server URL exactly, then try again. If it persists, contact support. |
| Sign-in fails or loops | Sign in at Hypersonix directly to confirm your account works, then reconnect. |
| “The data is not available right now” | The data service may be busy or unavailable. Try again in a few minutes. |
| The answer says a breakdown is not available | The field is empty for your company's data. Ask your Hypersonix administrator whether it can be loaded. |
| The request was too broad | Add a date range or ask for a total or top-N instead of every row. |
| Numbers differ from another report | Ask the assistant which filters and dates it used. Differences usually come from the period, cancelled orders, or the store set. |
| The connector does not appear in a chat | Enable it in the chat's tools menu. On Team or Enterprise plans, ask your administrator to allow it. |
Reference: tools
You do not need these to use the connector. They are listed for administrators reviewing access.
| Tool | Purpose |
|---|---|
list_datasets |
Lists the datasets you can query |
search_business_knowledge |
Finds the documented rules and recipes for a question |
get_dataset_schema |
Shows one dataset's fields, metrics, and known traps |
query_data |
Answers a question from your company's data |
get_sales_performance |
Latest complete week's sales compared with the prior week and last year |
get_pricing_alerts |
Price optimization alerts and the revenue at stake |
Support
- Website: hypersonix.ai
- Support: customer.support@hypersonix.ai
