# Shopify through toolfare

> Orders, products, customers, inventory and collections from your store, through Shopify’s own Admin API — answered inside ChatGPT, Claude, Codex or Cursor, next to the ad spend that drove them. Add your store’s custom-app credentials to toolfare once; your AI reads the store through them, every read is free, and nothing can be changed.

Page: https://toolfare.ai/shopify

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to answer: What were our best-selling products last week?

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Then connect your Shopify account in the toolfare console (https://toolfare.ai/shopify#setup); calls fail until it is connected.

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server, create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in. Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above that many credits (1,000 credits = $3).

## Tools

### Anything the Admin API can read, from orders to inventory

Tool: `shopify_graphql_query`

A read-only query against your store’s Shopify Admin GraphQL API — products, orders, customers, inventory, collections and shop settings. Your AI writes the query; a mutation is rejected before anything is sent.

Ask:
- What were our best-selling products last week?
- How many orders came in yesterday, and what was the average order value?
- Which products are about to run out of stock?

## Price

Free to read: it is your own account, so toolfare pays nobody for the data and charges nothing per read. No per-read charge to observe. Reads need no purchase. Like every toolfare call, they run only while your balance holds at least $0.003, and that is not spent.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You want revenue and orders next to the campaigns that drove them.
- You want best sellers, slow movers or low stock without exporting a report.
- You want a customer or order looked up while you are already in a chat.

## Look elsewhere when

- You want order history older than about 60 days. The connection does not have Shopify’s all-orders scope.
- You want what happened on the storefront before checkout. That is your analytics account.
- You want to edit a product, refund an order or change inventory. The connection is read-only, and mutations are rejected.

## Limits

- Orders cover roughly the last 60 days; full order history needs a Shopify scope the connection does not request.
- Every question is a GraphQL query written by your AI, so an unusual question may take a second attempt to shape.
- Queries are subject to Shopify’s own API rate limits.