The agent-native Shopify analytics layer
Connect any AI agent to a Shopify store for orders, products, customers, and bulk revenue exports — all through the Model Context Protocol. Read-only by design: list and inspect data, export CSVs for joins against your ad spend, and run free-form Admin GraphQL when the typed tools don't cover what you need.
How it works
From signup to a Shopify-fed ROAS report in six steps.
Sign up and get an API key
Create a free account at gentic.co, generate an API key from your dashboard, and use it as a Bearer token to authenticate your agent.
Add the MCP server to your agent
Drop https://mcp.gentic.co/shopify into Claude Code, Claude Web, OpenClaw, Claude Cowork, ChatGPT, n8n, or any MCP-compatible client. Pass your Gentic API key as a Bearer token — or connect via OAuth on clients that support it.
Connect your Shopify store
In your Gentic dashboard → Integrations, paste your shop subdomain (the part before .myshopify.com) and an Admin API access token from a Shopify custom app. Grant whichever of read_orders / read_products / read_customers you actually want the agent to use — at least one is required.
Sanity-check the connection
Call shopify_connection_status (free) to confirm the store is connected, then get_shop_info (free) to grab the currency, timezone, and plan you'll need for downstream revenue math.
Pull orders, products, and customers
Use list_orders, list_products, list_customers (5¢ each) for cursor-paginated lists with typed filters; follow up with get_order / get_product / get_customer (free) for full single-record detail. Sorting defaults to the right key for analytics — orders by processed_at desc, customers by total_spent desc.
Export revenue for ROAS analysis
Run export_orders_report ($1/call) to get a 1-hour signed CSV download AND persist the rows to MotherDuck shopify_orders, where the schema matches meta_ad_insights so a join on processed_date is a single equality predicate.
Available tools
10 tools your AI agent can call through the Model Context Protocol.
export_orders_report
Export Shopify orders to a CSV (1-hour signed URL) AND persist to MotherDuck `shopify_orders` for SQL-level joins with `meta_ad_insights`.
get_customer
Fetch a single Shopify customer by ID.
get_order
Fetch a single Shopify order by ID.
get_product
Fetch a single Shopify product by ID or handle.
get_shop_info
Get basic information about the connected Shopify store: name, email, primary domain, currency, IANA timezone, weight unit, and plan.
list_customers
List Shopify customers.
list_orders
List Shopify orders.
list_products
List Shopify products, most recently updated first.
shopify_connection_status
Check whether the calling organization has connected a Shopify store.
shopify_graphql_query
Execute a read-only GraphQL query against the Shopify Admin API (version 2026-04).
Connect in seconds
Sign up, grab your API key, paste a Shopify Admin API token in the dashboard, and add the MCP server to your agent. Works with Claude Code, Claude Web, OpenClaw, Claude Cowork, ChatGPT, n8n, and any MCP client.
claude mcp add gentic-shopify \
--transport http \
https://mcp.gentic.co/shopify \
--header "Authorization: Bearer YOUR_API_KEY"You can also connect via OAuth — just add gentic-shopify as a connector in Claude or ChatGPT settings. No API key needed; authentication is handled automatically.
Install the Gentic agent skill to teach your agent the optimal workflow so it gets the best results automatically.
npx skills add gentic-co/agent-skillsWorks with Claude Code, Cursor, Copilot, and 40+ other agents.
Transparent per-call pricing
Connection checks, the single-record lookups, and shop info are free. List endpoints are 5¢, the GraphQL escape hatch is 10¢, and the bulk revenue export is $1 — no monthly seats.
| Tool | Cost |
|---|---|
| export_orders_report | 100¢ / call |
| get_customer | Free |
| get_order | Free |
| get_product | Free |
| get_shop_info | Free |
| list_customers | 5¢ / call |
| list_orders | 5¢ / call |
| list_products | 5¢ / call |
| shopify_connection_status | Free |
| shopify_graphql_query | 10¢ / call |
Pricing is pulled live from the Gentic MCP manifest so it always matches what you'll actually be charged.
Why agent-native Shopify?
The Shopify admin is built for humans. The Admin API is built for app developers. Gentic Shopify gives your agent direct, read-only API access through natural language — and pre-computes the fields you need for revenue analysis.
Read-only by design
Gentic's v1 Shopify surface is analytics-only. shopify_graphql_query rejects mutations and subscriptions server-side. Your agent can inspect everything and change nothing.
ROAS-ready exports
export_orders_report pre-computes net_revenue and processed_date so the SQL join against meta_ad_insights is one equality predicate — not a CASE-laden CTE.
Portable
Works with any MCP-compatible client — Claude Web, Claude Code, OpenClaw, ChatGPT, n8n, and more. Switch clients without changing a thing.
Pay per use
Free tools stay free: connection status, get_shop_info, and every single-record lookup. List endpoints are 5¢, the GraphQL escape hatch is 10¢, the bulk revenue export is $1. No monthly seats.