{
  "type": "agent-commerce-contract",
  "version": "1.1",
  "updated": "2026-03-28",
  "fidoDigitalCredentials": {
    "passkeys": {
      "status": "active",
      "description": "WebAuthn passkeys as optional 2FA for merchant dashboard accounts. Max 5 passkeys per user.",
      "endpoints": "/api/v1/auth/webauthn/*"
    },
    "merchantVerification": {
      "status": "active",
      "description": "Merchant identity verification via Digital Credentials API (Chrome 141+, Safari 26+). Supports EU Trust Lists (eIDAS/QWAC) and US mDL (AAMVA VICAL).",
      "protocols": ["openid4vp", "org-iso-mdoc"],
      "endpoints": "/api/v1/verification/credentials/*",
      "trustBoost": {
        "BASIC": 0.05,
        "STANDARD": 0.1
      }
    },
    "agentOperatorKya": {
      "status": "active",
      "description": "Agent operator identity verification via Verifiable Digital Credentials. Verified operators receive a +0.10 trust score boost.",
      "trustBoost": 0.1
    }
  },
  "platform": {
    "name": "AgenticMCPStores",
    "url": "https://www.agenticmcpstores.com",
    "api": "https://www.agenticmcpstores.com/api/v1",
    "docs": "https://www.agenticmcpstores.com/api/v1/docs",
    "openapi": "https://www.agenticmcpstores.com/api/v1/docs/json",
    "llmsTxt": "https://www.agenticmcpstores.com/llms.txt",
    "llmsTxtLarge": "https://www.agenticmcpstores.com/llms_large.txt",
    "protocolCoverageMatrix": "https://www.agenticmcpstores.com/en/protocol-coverage",
    "description": "Multi-merchant trust and execution layer for agentic commerce. Provides a single authenticated REST API for AI agents to search, compare, and purchase products across verified merchants."
  },
  "capabilities": [
    {
      "action": "search_products",
      "method": "POST",
      "path": "/agent/search",
      "description": "Search products across all connected merchants in one request. Supports filters by category, price range, verification level, and trust score.",
      "authentication": "required"
    },
    {
      "action": "get_product_detail",
      "method": "GET",
      "path": "/agent/products/{id}",
      "description": "Retrieve full product data including structured policies, trust signals, and merchant operational data.",
      "authentication": "required"
    },
    {
      "action": "compare_products",
      "method": "POST",
      "path": "/agent/compare",
      "description": "Side-by-side comparison of multiple products with normalised data, price range, and best trust score summary.",
      "authentication": "required"
    },
    {
      "action": "check_availability",
      "method": "GET",
      "path": "/agent/availability/{id}",
      "description": "Check real-time stock and price with freshness indicator (fresh < 1h, stale > 24h).",
      "authentication": "required"
    },
    {
      "action": "create_cart",
      "method": "POST",
      "path": "/agent/cart",
      "description": "Create a cart with stock validation and merchant grouping. Cart expires after 24 hours.",
      "authentication": "required"
    },
    {
      "action": "complete_checkout",
      "method": "POST",
      "path": "/agent/checkout",
      "description": "Complete checkout flow. Creates a per-merchant checkout session and returns checkout URLs. Does NOT process payments.",
      "authentication": "required"
    },
    {
      "action": "get_merchant_profile",
      "method": "GET",
      "path": "/agent/merchants/{slug}",
      "description": "Retrieve merchant profile with trust score, verification level, structured policies (return, shipping), and platform connectors.",
      "authentication": "required"
    }
  ],
  "authentication": {
    "type": "api_key",
    "header": "X-Agent-Api-Key",
    "prefix": "agnt_",
    "registration": "https://www.agenticmcpstores.com/en/developers"
  },
  "rateLimits": [
    {
      "tier": "FREE",
      "requestsPerMinute": 20,
      "notes": "Default for new keys"
    },
    {
      "tier": "GROWTH",
      "requestsPerMinute": 500,
      "notes": "Paid plan"
    },
    {
      "tier": "PRO",
      "requestsPerMinute": 1000,
      "notes": "Paid plan"
    },
    {
      "tier": "ENTERPRISE",
      "requestsPerMinute": null,
      "notes": "Custom SLA, unlimited"
    }
  ],
  "rateLimitHeaders": [
    "X-RateLimit-Limit",
    "X-RateLimit-Remaining",
    "X-RateLimit-Reset"
  ],
  "eligibilityRequirements": {
    "minimumVerificationLevel": "BASIC",
    "minimumTrustScore": 0.3,
    "description": "Only merchants with BASIC+ verification and trustScore >= 0.3 appear in agent API results."
  },
  "trustFramework": {
    "description": "Every merchant has a trustScore (0.0\u20131.0) computed every 6 hours from operational data. This is a platform operational reliability score, not a consumer review rating and not a legal certification.",
    "components": [
      {
        "name": "catalog_completeness",
        "weight": 0.15
      },
      {
        "name": "catalog_freshness",
        "weight": 0.15
      },
      {
        "name": "price_accuracy",
        "weight": 0.15
      },
      {
        "name": "availability_accuracy",
        "weight": 0.1
      },
      {
        "name": "policy_coverage",
        "weight": 0.1
      },
      {
        "name": "checkout_success_rate",
        "weight": 0.15
      },
      {
        "name": "fulfillment_rate",
        "weight": 0.1
      },
      {
        "name": "dispute_rate",
        "weight": 0.1
      }
    ],
    "methodologyUrl": "https://www.agenticmcpstores.com/en/trust#methodology"
  },
  "verificationLevels": [
    {
      "level": "UNVERIFIED",
      "description": "No verification completed"
    },
    {
      "level": "BASIC",
      "description": "Email and domain control verified"
    },
    {
      "level": "STANDARD",
      "description": "Business review completed"
    },
    {
      "level": "PREMIUM",
      "description": "Business review plus stronger operational history requirements"
    }
  ],
  "merchantStatusStates": [
    {
      "status": "active",
      "condition": "trustScore >= 0.5, not suspended",
      "visibility": "Full visibility in agent API results"
    },
    {
      "status": "deprioritized",
      "condition": "trustScore in [0.3, 0.5)",
      "visibility": "Appears after all active merchants in ranked results (hard boundary)"
    },
    {
      "status": "hidden",
      "condition": "trustScore in [0.2, 0.3)",
      "visibility": "Excluded from agent API, visible only in merchant dashboard"
    },
    {
      "status": "suspended",
      "condition": "trustScore < 0.2 or manually suspended",
      "visibility": "Excluded everywhere"
    }
  ],
  "ranking": {
    "formula": "relevanceScore = (text_relevance * 0.55) + (store_trust_score * 0.25) + (freshness * 0.10) + (in_stock * 0.10)",
    "factors": {
      "text_relevance": {
        "range": "0.0-1.0",
        "description": "Normalised sum of title match (1.0) + description match (0.5) + tag match (0.3), divided by 1.8"
      },
      "store_trust_score": {
        "range": "0.0-1.0",
        "description": "Operational reliability score described in trustFramework"
      },
      "freshness": {
        "range": "0.0-1.0",
        "tiers": {
          "< 1h": 1,
          "< 6h": 0.8,
          "< 24h": 0.6,
          ">= 24h": 0.3,
          "null": 0
        }
      },
      "in_stock": {
        "range": "0.0 or 1.0",
        "description": "1.0 if inventoryQuantity > 0, otherwise 0.0"
      }
    },
    "deprioritizationBoundary": "Products from stores with trustScore < 0.5 (deprioritized: true) are placed after all active-store products regardless of their computed relevanceScore. This is a hard two-tier sort, not a tiebreaker."
  },
  "connectedPlatforms": [
    {
      "platform": "Shopify",
      "status": "available"
    },
    {
      "platform": "WooCommerce",
      "status": "available"
    },
    {
      "platform": "PrestaShop",
      "status": "beta"
    },
    {
      "platform": "eBay",
      "status": "beta"
    }
  ],
  "agentRiskControls": {
    "description": "The platform applies anti-fraud and anti-abuse signals per checkout flow. Signal details are not exposed to protect integrity.",
    "documentedAt": "https://www.agenticmcpstores.com/en/trust#agent-rules",
    "merchantConfigurable": true,
    "configurableRules": [
      "maximum_order_value",
      "allowed_categories",
      "require_confirmation_above_threshold"
    ]
  },
  "dataNotice": {
    "isPaymentProcessor": false,
    "isMerchantOfRecord": false,
    "isLegalCertificationAuthority": false,
    "trustScoresAreGuarantees": false,
    "trustScoreDescription": "Trust scores and signals are decision-support tools, not guarantees of merchant quality."
  },
  "protocolDeclarations": {
    "acp": {
      "name": "Agent Commerce Protocol",
      "version": "1.0",
      "spec": "https://platform.openai.com/docs/plugins/commerce",
      "status": "production-ready",
      "provider": "stripe",
      "capabilities": {
        "inbound": true,
        "outbound": true,
        "settlement": "stripe",
        "sandbox": true
      },
      "detectionMethod": "X-Protocol header or body shape",
      "mcpTools": [
        "create_cart",
        "get_shipping_rates",
        "select_shipping_option",
        "apply_discount",
        "preview_checkout",
        "complete_checkout"
      ],
      "documentation": "/en/for-agents"
    },
    "ap2": {
      "name": "Agent Payment Protocol v2",
      "version": "0.1",
      "spec": "https://developers.google.com/agent-payment-protocol",
      "status": "beta",
      "provider": "google",
      "capabilities": {
        "inbound": true,
        "outbound": true,
        "settlement": "cart-mandate",
        "sandbox": true
      },
      "detectionMethod": "X-Protocol header or Cart Mandate body",
      "mcpTools": ["create_cart", "complete_checkout"],
      "documentation": "/en/for-agents"
    },
    "x402": {
      "name": "x402 Stablecoin Protocol",
      "version": "1.0",
      "spec": "https://www.x402.org/",
      "status": "production-ready",
      "provider": "coinbase",
      "capabilities": {
        "inbound": true,
        "outbound": true,
        "settlement": "USDC-on-chain",
        "sandbox": true
      },
      "detectionMethod": "PAYMENT-SIGNATURE or X-PAYMENT header",
      "currency": "USDC",
      "mcpTools": ["create_cart", "complete_checkout"],
      "documentation": "/en/for-agents"
    },
    "ucp": {
      "name": "Universal Commerce Protocol",
      "version": "2026-01-15",
      "spec": "/.well-known/ucp",
      "status": "active",
      "provider": "agenticmcpstores",
      "capabilities": {
        "inbound": true,
        "outbound": false,
        "settlement": "protocol-bridge",
        "sandbox": true
      },
      "detectionMethod": "UCP discovery endpoint",
      "mcpTools": ["ucp_discover", "ucp_checkout", "ucp_status"],
      "documentation": "/en/for-agents"
    }
  }
}