Back to search
snapfolda-ucp-mcp
MCP serverGitHub
Shopify UCP MCP endpoint for SnapFolda: 14 tools for catalog search, cart, checkout and orders.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/echochaofan--snapfolda-ucp-mcp)HTML
<a href="/listings/echochaofan--snapfolda-ucp-mcp"><img src="/api/listings/echochaofan--snapfolda-ucp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 125 lines
- # SnapFolda UCP MCP
- MCP endpoint for the [SnapFolda store](https://snapfolda.com). Shopify hosts it on the store's own domain, so the endpoint shares the store's hostname rather than running as a separate service.
- | | |
- |---|---|
- | Store | <https://snapfolda.com> |
- | Endpoint | `https://snapfolda.com/api/ucp/mcp` |
- | Transport | Streamable HTTP, POST only |
- | Protocol | MCP `2025-06-18`, UCP `2026-08-25` |
- | Server | `universal-commerce/0.1.0` |
- | Auth | none at the HTTP layer; each tool call carries an agent profile |
- This repository holds notes and a client example. The server runs on Shopify's platform, so questions about its behaviour belong to Shopify.
- ## What the store sells
- SnapFolda sells iPhone wallet cases. 143 style families are cut for 33 models, which makes 4,719 products and 19,536 variants, priced $24.99 to $89.99.
- Seven functional families cover the range: card and slim card holder, folio and flip wallet, magnetic flip, card wallet, detachable and removable wallet, crossbody, MagSafe wallet. Catalog makeup, product shape and the field quirks worth knowing are in [`docs/catalog.md`](docs/catalog.md). The model list is in [`docs/models.md`](docs/models.md).
- ## What a search returns
- `iPhone 18 Pro Max wallet case for travel` comes back with 10 hits from that one model family:
- - Vasa Note, folio wallet case, $24.99
- - Split Decision, removable wallet case, $34.99
- - Mandala Horizon, folio wallet case, $24.99
- Price is per style and colour is the variant, so a hit is a style, not a SKU. The full response, captured from the live endpoint, is in [`examples/search_catalog_sample.json`](examples/search_catalog_sample.json).
- ## Store facts
- Taken from the store's own policy pages. Useful when an agent has to answer "when will it arrive" without sending the buyer elsewhere.
- - Free tracked shipping, with duties and taxes prepaid
- - Processing takes 1 to 3 business days
- - Delivery takes 4 to 12 business days to the UK, France and Italy, and 7 to 12 to the US
- - Returns run for 30 days after delivery, unused and in original packaging, with an RMA. Change of mind returns are paid by the buyer and there is no restocking fee
- - 12 month warranty covers manufacturing defects
- - Refunds are issued 2 business days after inspection and post in 3 to 5 days
- - Support is support@snapfolda.com, answered within 24 hours on business days
- ## Discovery
- Two documents describe the endpoint:
- - `https://snapfolda.com/.well-known/ucp` returns the UCP profile with the endpoint, capabilities, and the current `payment_handlers` list.
- - `https://snapfolda.com/agents.md` is the store's guide for agents.
- `GET` on the endpoint returns 404. Send JSON-RPC over `POST`.
- ## Tools
- The server exposes 14 tools.
- ### Catalog
- - `search_catalog` product search by natural language, filters, or both
- - `lookup_catalog` resolve several product or variant GIDs in one call
- - `get_product` product detail with variants, price, and stock
- ### Store
- - `ask_business` answer questions about the store, its policies, and its services
- ### Cart and checkout
- - `create_cart`, `get_cart`, `update_cart`, `cancel_cart`
- - `create_checkout`, `get_checkout`, `update_checkout`, `complete_checkout`, `cancel_checkout`
- ### Orders
- - `get_order`
- `prompts/list` and `resources/list` appear in the server capabilities but return 422.
- ## Calling a tool
- Every tool takes `meta.ucp-agent.profile`, a public JSON URL that describes your agent. Shopify fetches that URL before running the tool. If it cannot be fetched, or it has no `ucp.version`, the call fails with 422 and one of `profile_unreachable`, `profile_malformed`, or `version_unsupported`.
- ```json
- {
- "jsonrpc": "2.0",
- "id": 1,
- "method": "tools/call",
- "params": {
- "name": "search_catalog",
- "arguments": {
- "meta": {
- "ucp-agent": {
- "profile": "https://your-domain.example/.well-known/agent-profile.json"
- }
- },
- "catalog": {
- "query": "iPhone 18 Pro wallet case"
- }
- }
- }
- }
- ```
- Send `Content-Type: application/json` and `Accept: application/json, text/event-stream`. The reply is either JSON or an SSE stream, and both carry the same JSON-RPC message.
- A catalog response has `products`, `pagination`, and `messages`. Prices are integers in ISO 4217 minor units with a separate currency code, so `{"amount": 3499, "currency": "USD"}` is $34.99.
- ## Limits
- `payment_handlers` in the UCP profile is empty. `complete_checkout` needs the buyer to approve on the checkout page or through Shop Pay, so it is not an unattended payment path.
- `agents.md` asks agents to identify themselves with Web Bot Auth and to honour `Retry-After` on 429.
- The store has about 4,700 products, so catalog search can return large payloads. Page with `pagination.cursor`.
- ## Files
- - `examples/python_client.py` connects, lists the tools, and runs one search
- - `examples/curl.md` has copy-paste requests
- - `examples/search_catalog_sample.json` is a real response, trimmed to two products
- - `docs/catalog.md` covers catalog size, product shape and field quirks
- - `docs/models.md` lists the 33 device families
- ## License
- MIT for this repository. The service is Shopify's.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.