
{
  "agent_meta": {
    "type": "agent_product",
    "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": 1,
      "iso_code": "DE"
    },
    "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": "product",
      "id_product": 251
    },
    "full_context_in_target_url": true,
    "requires_session_persistence": false,
    "manual_url_construction_allowed": false,
    "instruction": "When a requested language, delivery country or currency differs from request_context, fetch links.agent.contexts. Preserve dimensions not explicitly changed by the user, select the exact matching entry and follow target_url unchanged."
  },

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

  "instructions": {
    "purpose": "This endpoint provides the complete machine-readable representation of one product in the active language, delivery-country and currency context.",
    "rules": [
      "All prices, taxes, availability and actions in data.product apply only to request_context.",
      "When variants exist, select the matching entry from data.product.variant_offers and use its exact price, availability and action URL.",
      "Do not infer a variant price from the product-level price or from another variant.",
      "Use the exact action.url supplied by the selected offer. Do not construct add-to-cart URLs manually.",
      "When language, delivery country or currency must change, fetch links.agent.contexts and follow the exact matching target_url unchanged.",
      "Prices, taxes, inventory and availability are calculated by the shop.",
      "Do not invent unavailable product, variant, price, stock, shipping or checkout information."
    ]
  },

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

  "links": {
    "self": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/product?id_product=251&setCountry=1&setCurrency=1",
    "agent": {
      "root": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/root?setCountry=1&setCurrency=1",
      "sitemap": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/sitemap?setCountry=1&setCurrency=1",
      "search": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/search?setCountry=1&setCurrency=1",
      "cart": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/cart?setCountry=1&setCurrency=1",
      "product": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/product?id_product=251&setCountry=1&setCurrency=1",
      "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=product&id_product=251&setCountry=1&setCurrency=1"
    },
    "human": {
      "home": "https:\/\/musiccraft-instruments.com\/",
      "sitemap": "https:\/\/musiccraft-instruments.com\/en\/sitemap",
      "search": "https:\/\/musiccraft-instruments.com\/en\/search",
      "product": "https:\/\/musiccraft-instruments.com\/en\/p\/apito-samba-whistle-3-tone-251.html",
      "cart": "https:\/\/musiccraft-instruments.com\/en\/order",
      "contact": "https:\/\/musiccraft-instruments.com\/en\/contact-us"
    }
  },

  "commerce_model": {
    "pricing": "server_calculated",
    "tax": "server_calculated",
    "shipping": "server_calculated",
    "inventory": "live",
    "currencies": "context_based",
    "languages": "url_based"
  },

  "data": {
    "product": {
      "@context": "https://schema.org",
      "@type": "Product",
      "@id": "https:\/\/musiccraft-instruments.com\/en\/p\/apito-samba-whistle-3-tone-251.html#product",
      "url": "https:\/\/musiccraft-instruments.com\/en\/p\/apito-samba-whistle-3-tone-251.html",
      "urls": {
        "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/product?id_product=251&setCountry=1&setCurrency=1",
        "contexts": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/contexts?resource=product&id_product=251&setCountry=1&setCurrency=1",
        "human": "https:\/\/musiccraft-instruments.com\/en\/p\/apito-samba-whistle-3-tone-251.html"
      },

      "id_product": 251,
      "name": "Samba Whistle (Apito) \u2013 3-Tone Whistle",
      "description": "Classic Apito samba whistle with three distinct tones. Durable plastic construction for samba bands, percussion ensembles and music education.",
      "full_description": "The Apito samba whistle is an essential instrument for samba ensembles, percussion groups and rhythm workshops. Featuring three distinct pitches, it is traditionally used to lead samba baterias, giving clear musical cues and adding dynamic rhythmic accents.  Made from durable plastic, the whistle is lightweight, comfortable to hold and designed for regular use during rehearsals, performances and music lessons. Its black-and-white finish gives it a classic appearance while ensuring reliable everyday performance.  Whether used in Brazilian samba, percussion classes or educational settings, the 3-tone Apito is an easy-to-play instrument that helps coordinate ensembles and enhance rhythmic expression.",
      "additional_text": "Apito samba whistle \n 3 distinct tones \n Material: Plastic \n Colour: Black and White \n Lightweight and durable \n Ideal for samba bands, percussion groups and music education",

      "sku": "910\/03",
      "mpn": "910\/03",
      "ean13": "",
      "upc": "",

      "brand": {
        "@type": "Brand",
        "name": "MIGMA eG",
        "url": "https:\/\/musiccraft-instruments.com\/en\/migma-eg_21"      },

      "manufacturer": {
        "@type": "Organization",
        "id_manufacturer": 21,
        "name": "MIGMA eG",
        "url": "https:\/\/musiccraft-instruments.com\/en\/migma-eg_21"      },

      "supplier": {
        "@type": "Organization",
        "id_supplier": 1,
        "name": "Migma e.G."
      },

      "main_category": {
        "id_category": 18,
        "name": "Whistles",
        "link_rewrite": "whistles",
        "urls": {
          "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=18&setCountry=1&setCurrency=1",
          "human": "https:\/\/musiccraft-instruments.com\/en\/whistles-18"
        }
      },

      "categories": [
                            {
            "id_category": 4,
            "name": "Instruments",
            "link_rewrite": "instruments",
            "urls": {
              "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=4&setCountry=1&setCurrency=1",
              "human": "https:\/\/musiccraft-instruments.com\/en\/instruments-4"
            }
          },                    {
            "id_category": 6,
            "name": "Equipment & Essentials",
            "link_rewrite": "equipment-essentials",
            "urls": {
              "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=6&setCountry=1&setCurrency=1",
              "human": "https:\/\/musiccraft-instruments.com\/en\/equipment-essentials-6"
            }
          },                    {
            "id_category": 7,
            "name": "Restoration",
            "link_rewrite": "restoration",
            "urls": {
              "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=7&setCountry=1&setCurrency=1",
              "human": "https:\/\/musiccraft-instruments.com\/en\/restoration-7"
            }
          },                    {
            "id_category": 5,
            "name": "Highlight",
            "link_rewrite": "highlight",
            "urls": {
              "agent": "https:\/\/musiccraft-instruments.com\/en\/mcc\/mcc_agent\/category?id_category=5&setCountry=1&setCurrency=1",
              "human": "https:\/\/musiccraft-instruments.com\/en\/highlight-5"
            }
          }                        ],

      "features": [
                            {
            "id_feature": 1,
            "id_feature_value": 3,
            "name": "Product declaration",
            "value": "Single item"
          },                    {
            "id_feature": 15,
            "id_feature_value": 130,
            "name": "Taxation",
            "value": "Standard Rate"
          },                    {
            "id_feature": 9,
            "id_feature_value": 391,
            "name": "Instrument",
            "value": "Whistle"
          },                    {
            "id_feature": 18,
            "id_feature_value": 392,
            "name": "Core material",
            "value": "Plastic"
          }                        ],

      "agent_faqs": [
              ],

      "images": [
                            {
            "id_image": 2599,
            "cover": true,
            "position": 1,
            "legend": "Samba Whistle (Apito) \u2013 3-Tone Whistle",
            "url": "https:\/\/cdn1.musiccraft-instruments.com\/2599-large_default\/apito-samba-whistle-3-tone.webp"
          },                    {
            "id_image": 2600,
            "cover": false,
            "position": 2,
            "legend": "Samba Whistle (Apito) \u2013 3-Tone Whistle",
            "url": "https:\/\/cdn3.musiccraft-instruments.com\/2600-large_default\/apito-samba-whistle-3-tone.webp"
          }                        ],

            "shipping_weight": {
        "@type": "QuantitativeValue",
        "value": 0.1,
        "unitCode": "KGM",
        "note": "Shipping weight, not product content."
      },
      
      
      "variant_model": {
        "has_variants": false,
        "variant_count": 0,
        "default_id_product_attribute": 0
      },

      "offers": {
        "@type": "Offer",
        "offer_scope": "product",
        "id_product": 251,
        "id_product_attribute": 0,
        "url": "https:\/\/musiccraft-instruments.com\/en\/p\/apito-samba-whistle-3-tone-251.html",
        "price": 3.75,
        "priceCurrency": "EUR",
        "availability": "https://schema.org/InStock",
        "itemCondition": "https://schema.org/NewCondition",
        "seller": {
          "@type": "Organization",
          "name": "musiccraft - instruments",
          "url": "https:\/\/musiccraft-instruments.com\/",
          "telephone": "+49 (0) 34 20 63 14 888"        },
        "priceSpecification": {
          "@type": "PriceSpecification",
          "price": 3.75,
          "priceCurrency": "EUR",
          "valueAddedTaxIncluded": true        }
        ,

        
        "action": {
          "type": "add_to_cart",
          "method": "GET",
          "enabled": true,
          "quantity": 1,
          "url": "https:\/\/musiccraft-instruments.com\/en\/shopping-cart?add=1&id_product=251&qty=1&setCountry=1&setCurrency=1"
        }
              },

      "variant_offers": [
              ],

      "pricing": {
        "scope": "product",
        "default_id_product_attribute": 0,
        "delivery_country": "DE",
        "currency": "EUR",
        "currency_symbol": "\u20ac",
        "tax_rate": 19,
        "use_taxes": true,
        "show_taxes": true,
        "price_tax_included": 3.75,
        "price_tax_excluded": 3.15,
        "price_without_reduction": 3.15,
        "reduction_percent": 0,
        "reduction_price": 0      },

      "availability": {
        "status": "https://schema.org/InStock",
        "orderable": true,
        "available_for_order": true,
        "show_price": true,
        "quantity": 100,
        "minimal_quantity": 1,
        "variant_stock_available": false,
        "allow_buy_when_out_of_stock": false,
        "stock_management": false,
        "is_virtual": false      }
    },

    "actions": {
      "add_to_cart": {
        "type": "cart_add",
        "method": "GET",
        "requires_context": true,
        "required_context_parameters": [
          "setCountry",
          "setCurrency"
        ],
        "instruction": "Use the exact action.url from data.product.offers for a simple product or from the selected data.product.variant_offers entry. Respect action.enabled and action.quantity."
      }
    }
  }
}