Estroni Storefront

Name: Estroni Storefront
Author: estroni

estroni/storefront-mcp

Updated May 19, 2026
estroni/storefront-mcp

Read-only **Model Context Protocol** server for the [Estroni](https://estroni.

About

Read-only **Model Context Protocol** server for the [Estroni](https://estroni.com.au) storefront - Australian merino & low-tox women's activewear. [![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) Read-only **Model Context Protocol** server for the [Estroni](https://estroni.com.au) 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.

[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
Read-only **Model Context Protocol** server for the [Estroni](https://estroni.com.au) storefront - Australian merino & l
**Registry name:** io.github.estroni/storefront
**Transport:** Streamable HTTP (MCP protocol 2025-06-18)

Estroni Storefront by the numbers

Exposes 5 verified tools (MCP introspection)
Data as of Jul 9, 2026 (Skillselion catalog sync)

terminal

claude mcp add --transport http storefront https://mcp.estroni.com.au/mcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.estroni/storefront.svg)](https://skillselion.com/mcp/tool/io.github.estroni/storefront)

Transport	HTTP
Auth	None
Tools	5
Last updated	May 19, 2026
Repository	estroni/storefront-mcp ↗

How do agents access Estroni Storefront - MCP server capabilities without custom integration code?

Read-only **Model Context Protocol** server for the [Estroni](https://estroni.com.au) storefront - Australian merino & low-tox women's activewear.

Who is it for?

Developers wiring Estroni Storefront - MCP server into Cursor, Claude Desktop, or other MCP clients.

Skip if: Teams that need features outside the documented Estroni Storefront - MCP server tool surface.

What you get

Configured MCP host can call Estroni Storefront - MCP server tools with schemas from the server README.

Remote MCP registration to Estroni’s storefront proxy
Agent-queryable activewear catalogue via UCP-oriented tools
Reference integration for hosted commerce MCP patterns

By the numbers

[object Object]

At a glance

Estroni Storefront capabilities & compatibility

Capabilities: [![mcp](https://img.shields.io/badge/mcp compati · [![license: mit](https://img.shields.io/badge/li · read only **model context protocol** server for · **registry name:** io.github.estroni/storefront
Use cases: api development · orchestration
Runs: Local or remote
Pricing: Bring your own API key

From the docs

What Estroni Storefront says it does

io.github.estroni/storefront

README.md

https://mcp.estroni.com.au/mcp

README.md

Tools 5

Public tool metadata - what this server can do for an agent.

search_catalog2 params

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).

metaobjectMCP transport metadata for UCP agent discovery.
catalogobjectCatalog search parameters.

get_cart1 param

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

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

update_cart11 params

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.

cart_idstringIdentifier for the cart being updated. If not provided, a new cart will be created.
add_itemsarrayItems to add to the cart. Required when creating a new cart.
update_itemsarrayExisting cart line items to update quantities for. Use quantity 0 to remove an item.
remove_line_idsarrayList of line item IDs to remove explicitly.
buyer_identityobjectInformation about the buyer including email, phone, and delivery address.
delivery_addresses_to_addarrayInformation about the delivery addresses to add.
delivery_addresses_to_replacearrayDelivery addresses to apply to the cart, replaces all existing cart delivery addresses. Removes all delivery addresses when empty.
selected_delivery_optionsarrayThe delivery options to select for the cart.
discount_codesarrayDiscount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.
gift_card_codesarrayGift card codes to apply to the cart. Only prompt if customer mentions having a gift card.
notestringA note or special instructions for the cart. Optional - can ask if customer wants to add special instructions.

search_shop_policies_and_faqs2 params

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?"

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

get_product_details4 params

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.

product_idstringrequiredThe product ID, e.g. gid://shopify/Product/123
optionsobjectVariant 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.
countrystringISO 3166-1 alpha-2 country code for which to return localized results (e.g., 'US', 'CA', 'GB').
languagestringISO 639-1 language code for which to return localized results (e.g., 'EN', 'FR', 'DE').

README.md

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):

{
  "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

# 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

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.