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.

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.
  • Enable Agent Discovery in Sitemap and Robots: adds the agent-discovery sitemap (/sitemap_agentic_discovery.xml) to /sitemap.xml and injects an agent block into robots.txt pointing agents to /.well-known/ucp and /agents.md.
  • 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.

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.