Mud Wtr Authentication

generated: '2026-08-26'
method: probed
source: >-
  https://mudwtr.com/.well-known/oauth-authorization-server,
  https://mudwtr.com/.well-known/oauth-protected-resource, live MCP and GraphQL probes 2026-08-26
docs: https://shopify.dev/docs/agents/get-started/authentication
description: >-
  MUD\WTR publishes no OpenAPI, so this profile is built from the OAuth/OIDC discovery documents its
  own host serves and from live authenticated-vs-anonymous probes of each surface. The authorization
  server is Shopify's customer-account issuer bound to this shop, with all user-facing endpoints on
  account.mudwtr.com.
surfaces:
- surface: Storefront GraphQL API
  endpoint: https://mudwtr.com/api/2025-10/graphql.json
  scheme: none
  type: public
  probed: '2026-08-26'
  note: >-
    Answered a full introspection query and a shop query with no Authorization header and no
    X-Shopify-Storefront-Access-Token. Customer-scoped fields still require a customer access token
    minted by customerAccessTokenCreate.
- surface: Storefront MCP server
  endpoint: https://mudwtr.com/api/mcp
  scheme: none
  type: public
  probed: '2026-08-26'
  note: tools/list and tools/call both succeeded anonymously.
- surface: UCP Commerce MCP server
  endpoint: https://mudwtr.com/api/ucp/mcp
  scheme: http
  bearer_format: JWT
  type: agent-jwt
  probed: '2026-08-26'
  note: >-
    tools/list is anonymous. tools/call returns JSON-RPC error -32000 "AuthenticationRequired —
    Unauthorized: A valid JWT is required", and separately requires a UCP agent profile URI in
    meta.ucp-agent.profile (error -32001 invalid_profile_url when omitted).
- surface: Storefront JSON endpoints
  endpoint: https://mudwtr.com/products.json
  scheme: none
  type: public
  probed: '2026-08-26'
- surface: Customer Account
  endpoint: https://account.mudwtr.com/authentication/oauth/authorize
  scheme: oauth2
  type: authorization_code
  probed: '2026-08-26'
securitySchemes:
- name: customerAccountOAuth
  type: oauth2
  flow: authorization_code
  pkce: true
  code_challenge_methods_supported: [S256]
  issuer: https://shopify.com/authentication/13794345014
  authorization_endpoint: https://account.mudwtr.com/authentication/oauth/authorize
  token_endpoint: https://account.mudwtr.com/authentication/oauth/token
  end_session_endpoint: https://account.mudwtr.com/authentication/logout
  jwks_uri: https://account.mudwtr.com/authentication/.well-known/jwks.json
  grant_types_supported: [authorization_code, refresh_token, 'urn:ietf:params:oauth:grant-type:jwt-bearer']
  token_endpoint_auth_methods_supported: [client_secret_basic, client_secret_post]
  id_token_signing_alg_values_supported: [RS256]
  scopes: [openid, email, 'customer-account-api:full', 'customer-account-mcp-api:full']
  document: well-known/mud-wtr-oauth-authorization-server.json
- name: openIdConnect
  type: openIdConnect
  openIdConnectUrl: https://mudwtr.com/.well-known/openid-configuration
  claims_supported: [iss, sub, aud, exp, iat, nonce, sid, email, email_verified]
  subject_types_supported: [public]
  document: well-known/mud-wtr-openid-configuration.json
- name: agentJWT
  type: http
  scheme: bearer
  bearerFormat: JWT
  applies_to: https://mudwtr.com/api/ucp/mcp
  docs: https://shopify.dev/docs/agents/get-started/authentication
- name: customerAccessToken
  type: apiKey
  in: header
  header: X-Shopify-Customer-Access-Token
  applies_to: Storefront GraphQL customer-scoped fields and mutations
protected_resource:
  resource: https://mudwtr.com
  authorization_servers: [https://account.mudwtr.com, 'https://shopify.com/authentication/13794345014']
  bearer_methods_supported: [header]
  rfc: RFC 9728
  document: well-known/mud-wtr-oauth-protected-resource.json