Skip to main content

Settings

All settings are located at Stores -> Configuration -> Mirasvit Extensions -> Agentic Commerce.

tip

To apply the settings, clear the Magento cache after making changes.

General Settings​

  • Enable Agentic Commerce: master switch. When set to No, all agent-facing surfaces (MCP, JSON API, discovery files, merchant profile) return 404 regardless of the individual surface settings below.
  • Description Field Priority: the order in which product text attributes are read for the agent-facing description (used by the JSON API and every MCP tool). The list holds the three native fields — Description, Short Description, Meta Description — plus any custom textual attribute you add, and the first one with a non-empty value wins. The chosen value is still rendered through the CMS template filter. Drag a row by its grip handle to reorder it; the select and delete controls stay clickable. The list cannot be empty. The default order is Description, then Short Description, then Meta Description. Store-view scoped.

HTTP Surfaces​

Each surface can be toggled independently. They only take effect when Enable Agentic Commerce is Yes.

  • Enable Generic MCP Endpoint: enables the /agent/mcp storefront MCP server. AI clients (Claude, ChatGPT, and others) use this endpoint to call the catalogue tools directly.
  • Enable Public JSON Read API: enables the /agent/*.json public read endpoints (products, search, collections). No authentication is required, and responses are served with Cache-Control: public.
  • Enable UCP Merchant Profile: enables the /.well-known/ucp merchant profile document. It declares the supported UCP versions, capabilities, and the store signing key, so UCP agents can discover and connect to your store. This is what makes the store discoverable, and it is enabled by default.
  • Enable Agent Instructions: enables /llms.txt and /agents.md — Liquid-templated instruction files that tell AI agents how to interact with your store. agents.md is a byte-identical mirror of llms.txt.
  • Discovery Shared-Cache TTL (seconds): how long a shared cache (the built-in Full Page Cache or Varnish) may store the discovery endpoints (/llms.txt, /agents.md, /.well-known/ucp, and the agent sitemap). At 0 (the default) every discovery request reaches Magento, so agent-visit counts on the Agent Activity dashboard stay exact, but a heavily crawled store gets no shared-cache offload. Raise it (up to 3600) to let shared caches serve repeat requests for that many seconds — this offloads the backend but records discovery hits as a sampled heartbeat rather than an exact count. Agent clients always cache for 3600 seconds regardless. Store-view scoped.
  • Enable Agent Block in robots.txt: injects an agent block into robots.txt pointing agents to /.well-known/ucp and /agents.md. Independent of the agentic sitemap below.
  • Enable Agentic Discovery Sitemap: serves the agent-discovery sitemap (/sitemap_agentic_discovery.xml) and adds it as an entry in /sitemap.xml. Turn this off if you manage your sitemap with a third-party SEO module. Independent of the robots.txt agent block above.
  • Enable Agent Cart: enables the UCP Cart capability. Agents build a cart (create_cart / update_cart / get_cart over /agent/mcp) and receive a continue_url for the shopper to review and complete in the browser. The agent never performs checkout or payment.

Agent Cart​

  • Continue URL Landing Page: where the shopper lands when they follow the cart continue_url.

    • Cart: the cart review page (recommended).
    • Checkout: straight to checkout.

    This setting is available only when Enable Agent Cart is Yes.

Agent Instructions Template​

This group controls the content served at /llms.txt and /agents.md. Leave it untouched to use the built-in base template.

  • Policy Pages: CMS pages to include in the {{ policies }} template variable. Leave blank to show no policies section.
  • LLMs Template: the Liquid template rendered at /llms.txt and /agents.md. It is pre-filled with the built-in default — edit and Save to create a store-scoped override, or clear the field and Save to revert to the built-in default. See Agent instructions variables for the full list of available variables and the fields on each.
  • Preview: renders the template above against the currently selected store view, so you can check the output before saving.

For a step-by-step guide, see How to customize the agent instructions.

UCP Signing Key​

The UCP merchant profile at /.well-known/ucp is signed with an ES256 keypair so agents can trust it. The keypair is created automatically during setup:upgrade, so there is normally nothing to do here. This group is global (not store-view scoped).

  • Signing Key Status: shows whether a key exists and when it was generated.
  • Regenerate: creates a new keypair, replacing the current one. Use it only to recover a missing key or to rotate the keypair. Regenerating rotates the published key id, so any agent that pinned the old key will re-fetch /.well-known/ucp. The same action is available on the command line with bin/magento mst:agentic:ucp:signing-key (add --regenerate to rotate).

Agent Activity (Telemetry)​

  • Record Agent Activity: captures agent interactions (searches, product views, carts, checkouts) for the Agent Activity dashboard. Activity is recorded off the response path and contains no buyer PII.
  • Retain Activity For (days): agent activity older than this is pruned daily. The default is 90. This field is available only when Record Agent Activity is Yes.