SnapFolda UCP MCP
Busca y compra en el catálogo de fundas para iPhone de SnapFolda: 4,719 productos en 143 estilos y 33 modelos. Busca en el catálogo, crea un carrito y obtén un enlace de pago. Sin clave de API.
Documentación
SnapFolda UCP MCP
MCP endpoint for the SnapFolda store. 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. The model list is in 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.
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/ucpreturns the UCP profile with the endpoint, capabilities, and the currentpayment_handlerslist.https://snapfolda.com/agents.mdis 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_catalogproduct search by natural language, filters, or bothlookup_catalogresolve several product or variant GIDs in one callget_productproduct detail with variants, price, and stock
Store
ask_businessanswer questions about the store, its policies, and its services
Cart and checkout
create_cart,get_cart,update_cart,cancel_cartcreate_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.
{
"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.pyconnects, lists the tools, and runs one searchexamples/curl.mdhas copy-paste requestsexamples/search_catalog_sample.jsonis a real response, trimmed to two productsdocs/catalog.mdcovers catalog size, product shape and field quirksdocs/models.mdlists the 33 device families
License
MIT for this repository. The service is Shopify's.