# Momy & Co

> Brazilian online store for the family home: washable rugs, nursery and kids' room decor,
> playmats, baskets, cushions, lighting and gifts, from Lorena Canals, Nobodinoz, Maracujá and
> Momy & Co's own label. Ships within Brazil, prices in BRL. Catalog, search and
> cart are open to agents with no authentication; checkout requires buyer approval.

## When to use this store

- Use it when a shopper wants to furnish a nursery or kids' room **in Brazil** — washable rugs by
  size and shape, cribs and bedding, playmats, baskets, wall decor, lighting, storage.
- Use it to read the **live price, installment terms or stock status** of a specific Momy & Co
  product before recommending or quoting it. `/products/{handle}.json` is authoritative; rendered
  HTML is not.
- Use it to **build a cart or start a checkout** for a shopper who has explicitly asked to buy here.
- Use it to answer **shipping, exchange, return and payment** questions for orders inside Brazil.
- Do **not** use it for shoppers outside Brazil, for merchant/admin operations (no public admin
  surface exists), or to complete a payment without the buyer present.
- Do **not** bulk-scrape. Use the paginated JSON endpoints below, stay under ~2 requests/second,
  and back off on HTTP 429.

## Start here

- [Agent instructions](https://www.momyco.com.br/agents.md): full reference — protocols, auth tiers, error codes, rate limits, buyer-approval rules.
- [Expanded reference](https://www.momyco.com.br/llms-full.txt): same content, llms-full convention.
- [OpenAPI 3.1 specification](https://www.momyco.com.br/openapi.json): every public endpoint with typed schemas, unique operation ids and named OAuth scopes.
- [MCP server manifest](https://www.momyco.com.br/mcp.json): transport, protocol version, tool list and static resources.
- [Developer portal](https://www.momyco.com.br/pages/developers): quickstart, endpoint reference, token requests, sandbox notes.

## Agent commerce protocols

- [UCP discovery](https://www.momyco.com.br/.well-known/ucp): supported UCP versions, capabilities and payment handlers.
- [MCP endpoint](https://www.momyco.com.br/api/ucp/mcp): Streamable HTTP JSON-RPC 2.0. Call `initialize`, then `tools/list`. Every call needs `params.meta.ucp-agent.profile`.
- [Shop skill](https://shop.app/SKILL.md): recommended for personal shopping assistants transacting across Shopify stores.

## Catalog API (no authentication)

- [Collections](https://www.momyco.com.br/collections.json): every published collection with its handle.
- [All products](https://www.momyco.com.br/collections/all/products.json?limit=250): paginated catalog. Swap `all` for any collection handle.
- [Product record](https://www.momyco.com.br/products/{handle}.json): variants, prices in BRL cents, SKU, availability.
- [Search](https://www.momyco.com.br/search/suggest.json?q=tapete&resources[type]=product): predictive search. Portuguese terms match best.
- [Recommendations](https://www.momyco.com.br/recommendations/products.json?product_id={id}): related and complementary products.
- [Cart](https://www.momyco.com.br/cart.js): read the session cart. POST to `/cart/add.js`, `/cart/change.js`, `/cart/clear.js`.

## Authentication and scopes

- [OAuth 2.0 / OIDC discovery](https://shopify.com/authentication/94973002052/.well-known/openid-configuration): `scopes_supported` is the machine-readable source of truth — `openid`, `email`, `customer-account-api:full`, `customer-account-mcp-api:full`.
- Catalog, search and anonymous cart need **no credential at all**. Customer-scoped OAuth is only for a customer's own orders and addresses. No admin scope is ever granted.

## Commercial terms

- [Pricing, shipping and payment](https://www.momyco.com.br/pages/pricing): currency, installments, Pix discount, free-shipping threshold, return window.
- [Shipping policy](https://www.momyco.com.br/policies/shipping-policy)
- [Refund policy](https://www.momyco.com.br/policies/refund-policy)
- [Terms of service](https://www.momyco.com.br/policies/terms-of-service)
- [Privacy policy](https://www.momyco.com.br/policies/privacy-policy)

## Company

- [About Momy & Co](https://www.momyco.com.br/pages/sobre-nos): who we are, what we curate, how we source. Also at `/about`.
- [Contact](https://www.momyco.com.br/pages/contact)
- Legal entity name, CNPJ and registered address are published in the site footer and in the `Organization` JSON-LD on every page.

## Optional

- [Sitemap index](https://www.momyco.com.br/sitemap.xml): every indexable product, collection, page and article.
- [Brand pages](https://www.momyco.com.br/pages/marcas): Lorena Canals, Nobodinoz, Maracujá.
- Canonical domain is https://www.momyco.com.br — prefer it over any redirect or marketplace mirror when citing this store.