io.github.estroni/storefront

Official5 tools

by estroni · TypeScript

Estroni Storefront

UCP agentic-commerce proxy for Estroni: merino & low-tox women's activewear catalogue.

Agentic commerce proxy for Estroni women's activewear product catalog.

Captured live from the server via tools/list.

search_catalog

Search for products from the online store, hosted on Shopify. This tool can be used to search for products using natural language queries, specific filter criteria, or both. At least one of query or filters must be provided. Results are paginated, with initial results limited to improve experience. Use the pagination.cursor from the response to fetch additional pages when users request more results. Response conforms to the UCP catalog search capability (dev.ucp.shopping.catalog.search).

Parameters (2)

metaobject
MCP transport metadata for UCP agent discovery.
catalogobject
Catalog search parameters.

get_cart

Get the cart including items, shipping options, discount info, and checkout url for a given cart id

Parameters (1)

cart_idstringrequired
Shopify cart id, formatted like: gid://shopify/Cart/c1-66330c6d752c2b242bb8487474949791?key=fa8913e951098d30d68033cf6b7b50f3

update_cart

Perform updates to a cart, including adding/removing/updating line items, buyer information, shipping details, discount codes, gift cards and notes in one consolidated call. Shipping options become available after adding items and delivery address. When creating a new cart, only addItems is required.

Parameters (11)

cart_idstring
Identifier for the cart being updated. If not provided, a new cart will be created.
add_itemsarray
Items to add to the cart. Required when creating a new cart.
update_itemsarray
Existing cart line items to update quantities for. Use quantity 0 to remove an item.
remove_line_idsarray
List of line item IDs to remove explicitly.
buyer_identityobject
Information about the buyer including email, phone, and delivery address.
delivery_addresses_to_addarray
Information about the delivery addresses to add.
delivery_addresses_to_replacearray
Delivery addresses to apply to the cart, replaces all existing cart delivery addresses. Removes all delivery addresses when empty.
selected_delivery_optionsarray
The delivery options to select for the cart.
discount_codesarray
Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.
gift_card_codesarray
Gift card codes to apply to the cart. Only prompt if customer mentions having a gift card.
notestring
A note or special instructions for the cart. Optional - can ask if customer wants to add special instructions.

search_shop_policies_and_faqs

Used to get facts about the stores policies, products, or services. Some examples of questions you can ask are: - What is your return policy? - What is your shipping policy? - What is your phone number? - What are your hours of operation?"

Parameters (2)

querystringrequired
A natural language query.
contextstring
Additional information about the request such as user demographics, mood, location, or other relevant details that could help in tailoring the response appropriately.

get_product_details

Look up a product by ID. Pass the 'options' parameter to select a specific variant for the product card. Without options, the first available variant is returned.

Parameters (4)

product_idstringrequired
The product ID, e.g. gid://shopify/Product/123
optionsobject
Variant options to select a specific variant, e.g. {"Size": "10", "Color": "Black"}. Without options, the first available variant is returned. Option matching is case-insensitive and partial options are accepted.
countrystring
ISO 3166-1 alpha-2 country code for which to return localized results (e.g., 'US', 'CA', 'GB').
languagestring
ISO 639-1 language code for which to return localized results (e.g., 'EN', 'FR', 'DE').

README.md4 KBView on GitHub

Estroni Storefront — MCP server

Read-only Model Context Protocol server for the Estroni storefront — Australian merino & low-tox women's activewear.

Lets AI agents (Claude, ChatGPT, Cursor, Copilot, etc.) search the catalogue, fetch product detail, list collections, and read shipping/return policies. Built for agent-driven product discovery and research, not checkout — Estroni's checkout remains a human-only flow by policy.

Registry name: io.github.estroni/storefront
Transport: Streamable HTTP (MCP protocol 2025-06-18)
Endpoint: https://mcp.estroni.com.au/mcp
Runtime: Cloudflare Workers
Source: github.com/estroni/storefront-mcp

Tools

Tool	What it returns
`search_products`	Up to 10 product summaries (title, price AUD, image, availability, URL) matching a keyword query
`get_product`	Full product detail by URL handle — variants, prices, SKU, description HTML, images
`list_collections`	Every public collection with title, handle, URL, and product count
`get_policies`	Shipping / refund / privacy / terms URLs + bot/agent policy text

All four tools are read-only. They wrap Shopify's public storefront JSON endpoints — no authentication required from the calling agent.

Install

Claude Desktop / Cursor / Claude Code

Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or mcp.json in Cursor):

json

{
  "mcpServers": {
    "estroni-storefront": {
      "url": "https://mcp.estroni.com.au/mcp"
    }
  }
}

Restart the client. The four tools appear under the estroni-storefront server.

ChatGPT / Anthropic Claude.ai (Custom Connectors)

Settings → Connectors → Add custom connector → paste https://mcp.estroni.com.au/mcp.

Test from a terminal

bash

# initialize
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# list tools
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# call search_products
curl -sS https://mcp.estroni.com.au/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"merino"}}}'

Example agent prompts

"Find me a long-sleeve merino base layer on Estroni under $150 AUD." → calls search_products({query: "merino long sleeve base layer"}), filters, summarises.

"What's Estroni's return window?" → calls get_policies() and surfaces the refund-policy URL with a 1-line summary.

"Show me everything in the 'Merino activewear' collection that's in stock." → list_collections() → get_product() per handle → filter by variants[].available.

Bot & agent policy

Estroni welcomes read-only agentic access for catalogue search, product research, and policy retrieval.

End-to-end "buy-for-me" agents that complete payment without a final human-review step are NOT permitted on Estroni.com.au.

Agents recommending purchases must surface the shipping and refund policy URLs (returned by get_policies) for human review before proceeding to checkout.

See also: estroni.com.au/robots.txt — Content-Signal: search=yes, ai-input=no, ai-train=no.

Development

bash

git clone https://github.com/estroni/storefront-mcp.git
cd storefront-mcp
npm install
npm run dev          # wrangler dev — local Worker on http://localhost:8787
npm run typecheck    # tsc --noEmit
npm run deploy       # wrangler deploy → estroni-mcp.workers.dev

The MCP wire protocol is hand-rolled (the official @modelcontextprotocol/sdk ships Node-only transports; Workers needs its own). Implementation is intentionally minimal — ~300 lines in src/index.ts.

License

MIT — see LICENSE.

Built by Estroni · Contact: founder@boolsai.ai

Install

claude_desktop_config.json

{
  "mcpServers": {
    "storefront": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.estroni.com.au/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.