ShopifyQL MCP

A Model Context Protocol server for querying ShopifyQL.

Endpoint

Streamable HTTP:

/api/mcp?token=<MCP_AUTH_TOKEN>

SSE (legacy):

/api/sse?token=<MCP_AUTH_TOKEN>

Requests without a matching token query parameter are rejected with HTTP 401.

Tools

• execute_shopifyql_query(query, domain) — run a ShopifyQL query against one of your authorized shops.
• list_authorized_domains() — list the shop domains the presented token may query.
• get_shopifyql_schema(source?) — return the bundled ShopifyQL catalog.
• get_recent_sales_count(domain, minutes, channel?) — count the orders placed on a shop in the last minutes minutes. channel is a comma-separated list of sales channel handles (web, pos, shop, …) and defaults to all.
• list_sales_channels(domain, limit?) — which sales channels the last limit orders came through (default 1000), with an order count and last-order time each. Use it to find valid channel handles.

REST endpoints

Same token, plain HTTP:

• POST /api/query — body { query, domain }.
• GET /api/sales/count?domain=<shop>&minutes=<n>&channel=web,shop — orders in the last n minutes (1–10080). channel is optional and defaults to all, which includes Point of Sale.
• GET /api/sales/channels?domain=<shop>&limit=1000 — sales channels of the most recent orders. limit is optional (1–1000, default 1000).