{
  "$schema": "https://modelcontextprotocol.io/schema/manifest.json",
  "name": "momyco-storefront",
  "display_name": "Momy & Co Storefront",
  "description": "MCP server for the Momy & Co online store (Brazil): search the catalog of washable rugs, nursery and kids' decor, build a cart and start a buyer-approved checkout. Implements the Universal Commerce Protocol shopping service.",
  "version": "2026-04-08",
  "vendor": "Momy & Co",
  "homepage": "https://www.momyco.com.br",
  "documentation": "https://www.momyco.com.br/agents.md",
  "developer_portal": "https://www.momyco.com.br/pages/developers",
  "openapi": "https://www.momyco.com.br/openapi.json",
  "transport": "streamable-http",
  "endpoint": "https://www.momyco.com.br/api/ucp/mcp",
  "protocol_version": "2025-06-18",
  "servers": {
    "momyco-storefront": {
      "type": "http",
      "url": "https://www.momyco.com.br/api/ucp/mcp"
    }
  },
  "ucp": {
    "discovery": "https://www.momyco.com.br/.well-known/ucp",
    "supported_versions": ["2026-04-08", "2026-01-23"],
    "service": "dev.ucp.shopping"
  },
  "authentication": {
    "catalog": "none",
    "agent_identity": {
      "required": true,
      "location": "params.meta.ucp-agent.profile",
      "description": "Every tools/call must carry a publicly fetchable agent profile URI. Calls without it are rejected with JSON-RPC error -32001 and HTTP 422. resources/list and prompts/list share this requirement."
    },
    "customer_scoped": {
      "type": "oauth2",
      "flow": "authorization_code",
      "discovery": "https://shopify.com/authentication/94973002052/.well-known/openid-configuration",
      "authorization_endpoint": "https://shopify.com/authentication/94973002052/oauth/authorize",
      "token_endpoint": "https://shopify.com/authentication/94973002052/oauth/token",
      "scopes_supported": [
        "openid",
        "email",
        "customer-account-api:full",
        "customer-account-mcp-api:full"
      ],
      "scope_descriptions": {
        "openid": "Authenticate the customer and receive a subject identifier. Grants no profile or order access on its own.",
        "email": "Read the authenticated customer's email address.",
        "customer-account-api:full": "Read and write the authenticated customer's own orders, addresses and payment methods.",
        "customer-account-mcp-api:full": "Call customer-scoped MCP tools on behalf of the authenticated customer."
      }
    }
  },
  "capabilities": {
    "tools": true,
    "prompts": true,
    "resources": true,
    "logging": true
  },
  "tools": [
    { "name": "search_catalog", "description": "Search the Momy & Co catalog by free text, price range and availability." },
    { "name": "lookup_catalog", "description": "Look up specific catalog items by id or handle." },
    { "name": "get_product", "description": "Return one product with all variants, prices in BRL minor units, and availability." },
    { "name": "create_cart", "description": "Create a cart with one or more variants." },
    { "name": "get_cart", "description": "Read a cart's line items and totals." },
    { "name": "update_cart", "description": "Add, change or remove cart lines." },
    { "name": "cancel_cart", "description": "Discard a cart." },
    { "name": "create_checkout", "description": "Start a checkout from a cart." },
    { "name": "get_checkout", "description": "Read checkout line items, totals, discounts and taxes." },
    { "name": "update_checkout", "description": "Set the shipping address and delivery method." },
    { "name": "complete_checkout", "description": "Finalise payment. REQUIRES contemporaneous human approval; never call autonomously." },
    { "name": "cancel_checkout", "description": "Abandon a checkout." },
    { "name": "get_order", "description": "Read an order's status and fulfilment." }
  ],
  "resources": {
    "note": "The upstream Shopify UCP server advertises the resources capability in its initialize handshake. resources/list currently requires the same params.meta.ucp-agent.profile envelope as tools/call and returns JSON-RPC error -32001 (invalid_profile_url) when it is missing. Send the profile URI to enumerate resources.",
    "static": [
      {
        "uri": "https://www.momyco.com.br/agents.md",
        "name": "Agent instructions",
        "description": "When to use this store, protocols, policies and rate limits.",
        "mimeType": "text/markdown"
      },
      {
        "uri": "https://www.momyco.com.br/openapi.json",
        "name": "OpenAPI 3.1 specification",
        "description": "Every public storefront endpoint with typed schemas and named OAuth scopes.",
        "mimeType": "application/json"
      },
      {
        "uri": "https://www.momyco.com.br/.well-known/ucp",
        "name": "UCP merchant profile",
        "description": "Supported UCP versions, capabilities and payment handlers.",
        "mimeType": "application/json"
      },
      {
        "uri": "https://www.momyco.com.br/sitemap.xml",
        "name": "Sitemap index",
        "description": "Every indexable product, collection, page and article.",
        "mimeType": "application/xml"
      },
      {
        "uri": "https://www.momyco.com.br/collections.json",
        "name": "Collection catalog",
        "description": "All published collections with handles for paginated product listings.",
        "mimeType": "application/json"
      }
    ]
  },
  "when_to_use": [
    "The shopper is looking for washable rugs, nursery or kids' room decor, playmats, baskets, cushions or gifts, and wants to buy in Brazil.",
    "You need the live price, installment terms or stock status of a specific Momy & Co product.",
    "You are building a cart or starting a checkout that the shopper will approve."
  ],
  "when_not_to_use": [
    "The shopper is outside Brazil. This store ships domestically and prices in BRL only.",
    "You need merchant or admin operations. No public admin surface exists.",
    "You want to complete a payment without the buyer present. That is never permitted."
  ],
  "rate_limits": {
    "policy": "Per-IP. Back off on HTTP 429 and honour Retry-After.",
    "recommended_max_rps": 2
  },
  "contact": "https://www.momyco.com.br/pages/contact",
  "policies": {
    "privacy": "https://www.momyco.com.br/policies/privacy-policy",
    "terms": "https://www.momyco.com.br/policies/terms-of-service",
    "refund": "https://www.momyco.com.br/policies/refund-policy",
    "shipping": "https://www.momyco.com.br/policies/shipping-policy"
  }
}