


{
  "agent_meta": {
    "type": "agent_root",
    "schema": "mcc_agent",
    "schema_version": "1.1",
    "generated_at": "2026-11-07",
    "source_of_truth": "MCC Commerce Engine"
  },

  "request_context": {
    "language": {
      "id_lang": 2,
      "iso_code": "en",
      "url_prefix": "\/en\/"
    },
    "delivery_country": {
      "id_country": 0,
      "iso_code": false
    },
    "currency": {
      "id_currency": 1,
      "iso_code": "EUR",
      "name": "Euro",
      "symbol": "\u20ac"
    },
    "complete": true
  },

  "context_switching": {
    "available": true,
    "mode": "on_demand_resolver",
    "stateless": true,
    "resolver": "links.agent.contexts",
    "fetch_when": "requested_context_differs",
    "dimensions": [
      "language",
      "delivery_country",
      "currency"
    ],
    "unspecified_dimensions": "preserve_request_context",
    "selection": {
      "match": "exact",
      "source": "available_contexts",
      "result": "available_contexts[].target_url"
    },
    "target": {
      "resource": "root"
    },
    "full_context_in_target_url": true,
    "requires_session_persistence": false,
    "manual_url_construction_allowed": false,
    "instruction": "Compare the requested language, delivery country and currency with request_context. If at least one requested dimension differs, fetch links.agent.contexts, preserve every dimension not explicitly changed, select the exact matching available_contexts entry and follow target_url unchanged."
  },

  "platform": {
    "name": "MCC Agentic Commerce",
    "version": "1.1",
    "commerce_engine": "MCC Commerce Engine",
    "agent_interface": "MCC Agentic API"
  },

  "instructions": {
    "purpose": "This endpoint is the main machine-readable entry point for AI agents using this webshop.",
    "rules": [
      "Use Agent endpoints instead of scraping HTML whenever available.",
      "Use search for product discovery.",
      "Use product endpoints for complete product data, variants, availability and prices.",
      "Use category endpoints to browse a known product category.",
      "Use cart endpoint to inspect the current cart.",
      "Prices, taxes, shipping and availability are calculated by the shop.",
      "Do not invent unavailable product, price, stock, shipping or checkout information.",
      "Compare the requested language, delivery country and currency with request_context before changing context.",
      "When at least one requested context dimension differs, fetch links.agent.contexts.",
      "Preserve every context dimension the user did not explicitly request to change.",
      "Follow the selected target_url unchanged. Do not construct context URLs manually and never use ISO codes as values for setCountry or setCurrency."
    ]
  },

  "capabilities": {
    "root": true,
    "sitemap": true,
    "search": true,
    "product": true,
    "category": true,
    "cart": true,
    "contexts": true,
    "cms_page": false,
    "checkout": false
  },

  "links": {
    "self": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/root?setCountry=0&setCurrency=1",
    "agent": {
      "root": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/root?setCountry=0&setCurrency=1",
      "sitemap": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/sitemap?setCountry=0&setCurrency=1",
      "search": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/search?setCountry=0&setCurrency=1",
      "cart": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/cart?setCountry=0&setCurrency=1",
      "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=root&setCountry=0&setCurrency=1"
    },
    "human": {
      "home": "https:\/\/musiccraft-instruments.com\/",
      "sitemap": "https:\/\/musiccraft-instruments.com\/en\/sitemap",
      "search": "https:\/\/musiccraft-instruments.com\/en\/search",
      "cart": "https:\/\/musiccraft-instruments.com\/en\/order",
      "contact": "https:\/\/musiccraft-instruments.com\/en\/contact-us"
    }
  },

  "commerce_model": {
    "source_of_truth": "MCC Commerce Engine",
    "pricing": "server_calculated",
    "tax": "server_calculated",
    "shipping": "server_calculated",
    "inventory": "live",
    "currencies": "context_based",
    "languages": "url_based",
    "context_authority": "links.agent.contexts"
  },

  "data": {
    "offers": {
      "new_products": "https:\/\/musiccraft-instruments.com\/en\/new-products",
      "best_sellers": "https:\/\/musiccraft-instruments.com\/en\/bestsellers",
      "price_drop": "https:\/\/musiccraft-instruments.com\/en\/special-offers",
      "manufacturers": "https:\/\/musiccraft-instruments.com\/en\/manufacturers"
    },

    "account": {
      "is_logged": false,
      "urls": {
        "my_account": "https:\/\/musiccraft-instruments.com\/en\/my-account",
        "authentication": "https:\/\/musiccraft-instruments.com\/en\/authentication",
        "addresses": "https:\/\/musiccraft-instruments.com\/en\/addresses",
        "order_history": "https:\/\/musiccraft-instruments.com\/en\/order-history"
      }
    },

    "categories": [
                        
                  {
          "id_category": 4,
          "name": "Instruments",
          "children_count": 6,
          "urls": {
            "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=4&setCountry=0&setCurrency=1",
            "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=category&id_category=4&setCountry=0&setCurrency=1",
            "human": "https:\/\/musiccraft-instruments.com\/en\/instruments-4"
          },
          "context_instruction": "Fetch urls.contexts only when the requested language, delivery country or currency differs from request_context. Select the exact matching available_contexts entry and follow target_url unchanged."
        },                  
                  {
          "id_category": 6,
          "name": "Equipment & Essentials",
          "children_count": 7,
          "urls": {
            "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=6&setCountry=0&setCurrency=1",
            "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=category&id_category=6&setCountry=0&setCurrency=1",
            "human": "https:\/\/musiccraft-instruments.com\/en\/equipment-essentials-6"
          },
          "context_instruction": "Fetch urls.contexts only when the requested language, delivery country or currency differs from request_context. Select the exact matching available_contexts entry and follow target_url unchanged."
        },                  
                  {
          "id_category": 7,
          "name": "Restoration",
          "children_count": 0,
          "urls": {
            "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=7&setCountry=0&setCurrency=1",
            "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=category&id_category=7&setCountry=0&setCurrency=1",
            "human": "https:\/\/musiccraft-instruments.com\/en\/restoration-7"
          },
          "context_instruction": "Fetch urls.contexts only when the requested language, delivery country or currency differs from request_context. Select the exact matching available_contexts entry and follow target_url unchanged."
        },                  
                  {
          "id_category": 5,
          "name": "Highlight",
          "children_count": 0,
          "urls": {
            "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=5&setCountry=0&setCurrency=1",
            "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=category&id_category=5&setCountry=0&setCurrency=1",
            "human": "https:\/\/musiccraft-instruments.com\/en\/highlight-5"
          },
          "context_instruction": "Fetch urls.contexts only when the requested language, delivery country or currency differs from request_context. Select the exact matching available_contexts entry and follow target_url unchanged."
        }                  ],

    "cms_pages": [
                      {
          "id_cms": 8,
          "title": "Registration as a wholesaler",
          "url": "https:\/\/musiccraft-instruments.com\/en\/cms\/registration-wholesaler-8"
        },                {
          "id_cms": 39,
          "title": "Newsletter Danke",
          "url": "https:\/\/musiccraft-instruments.com\/en\/cms\/newsletter-danke-39"
        },                {
          "id_cms": 57,
          "title": "Newsletter registration successful",
          "url": "https:\/\/musiccraft-instruments.com\/en\/cms\/newsletter-registration-successful-57"
        },                {
          "id_cms": 58,
          "title": "Newsletter registration error",
          "url": "https:\/\/musiccraft-instruments.com\/en\/cms\/newsletter-registration-error-58"
        }                  ],

    "service_pages": [
      {
        "type": "contact",
        "title": "Contact",
        "url": "https:\/\/musiccraft-instruments.com\/en\/contact-us"
      },
      {
        "type": "stores",
        "title": "Stores",
        "url": "https:\/\/musiccraft-instruments.com\/en\/our-retailers"
      }    ],

    "contact_channels": {
      "support_phone": {
        "display": "+49 (0) 34 20 63 14 888",
        "callable": "+49034206314888",
        "description": "Customer support phone number"
      },
      "support_email": "noreply@musiccraft-instruments.com",
      "availability": {
        "text": "Mo-Fr 09:00-16:00",
        "timezone": "Europe/Berlin"
      },
      "human_fallback_url": "https:\/\/musiccraft-instruments.com\/en\/contact-us"
    },

    "shop_identity": {
      "name": "musiccraft - instruments",
      "domain": "https:\/\/musiccraft-instruments.com\/",
      "contact_url": "https:\/\/musiccraft-instruments.com\/en\/contact-us"
    }
  }
}
