Skip to main content

// ask magistry

Ask about the business. Approve the change.

Ask Magistry is the chat inside your Magistry dashboard. It reads your orders, catalog, ads and helpdesk with live tools, answers with the figures it found, and prepares store changes as approval cards you confirm.

Live Live data Approval cards Same tools as the API
ask magistry · example
How did yesterday go?
M
I read yesterday's orders and Google Ads spend. Sales were up on the day before, and one campaign ran out of budget by mid-afternoon. I prepared a budget increase for it. Approve it when you are ready.
ads_set_campaign_budget · approval

// what it does

Questions in, figures and prepared changes out.

Ask in plain language. Ask Magistry picks the tools that hold the answer, reads them, and replies with what they returned. When the answer is a change to the store, it prepares that change and waits for you.

Reads your live data first

Orders, products, Google Ads performance, Search Console, helpdesk threads and disputes. Ask Magistry calls its tools to read them before it states a number, and quotes the figures those tools return.

Prepares the change for approval

A price, a product status, a refund, a Google Ads budget or a customer reply comes back as an approval card. The store only changes when you approve it, in the dashboard or in the mobile app.

Shows figures as tiles and charts

Numbers come back as a tile, a chart or a short list, drawn only from figures a tool actually returned.

// bring your own AI

Use the same tools from your own AI.

The tool registry behind Ask Magistry also powers an MCP server and a REST API. Connect an MCP client such as Claude or Cursor and work with your store from where you already work.

MCP server

Connect any MCP client over Streamable HTTP, with OAuth 2.1 and store and scope selection, or with an API key as a Bearer token.

REST API

Each tool is callable as POST /api/v1/tools/{tool} with a scoped API key, documented in an OpenAPI spec. Scopes are set per resource and action.

Approval cards

When a connected AI asks for a store change such as a price, a refund or a budget, it gets an approval card back, and you confirm it in the dashboard.

// example conversations

Answers built from what the tools returned.

These conversations are illustrative examples, not live store data. The chips under each one name the tools the answer would call.
// sales check-in
How did last week compare with the week before?
M
I read the orders for both weeks and compared them day by day.
Revenue and order count are side by side in the chart below, with the products that moved most listed underneath.
compare_periodsget_orders_summaryrender_chart
// price change
Lower the price of the linen throw to 79.
M
I prepared the price change for all variants of the linen throw.
It is waiting as an approval card. Nothing changes in the store until you approve it.
get_variantsshopify_update_variant_price · approval
// helpdesk
Which customer threads need me today?
M
I read the open helpdesk threads that are waiting on a person, and the open disputes.
Two are return requests and one dispute has its response deadline this week. I can prepare a reply to any of them for you to approve.
get_cs_attentionget_disputescs_send_reply · approval

// how it answers

It reads before it answers.

Ask Magistry is instructed to read live data with its tools before it states a number, and to quote the figures those tools return. It is also told to be honest about what it does not know.

It never reports a change as applied unless a tool result says so. A change that is still waiting for your approval is described as waiting.

// what waits for your approval

Prices, product status, inventory, tags and product content. Refunds, cancellations, discount codes and gift cards. Google Ads budgets, campaign status and negative keywords. Replies to customers.

Small, reversible actions, such as starting a data sync or creating an alert, run straight away and are written to the decision log.

// ask magistry

Ask your business a question.

Ask Magistry reads the live data, answers with the figures it found, and prepares price, refund, budget and reply changes for you to approve.

Live data · Approval cards · MCP server and REST API