{
    "name": "SoundCreation",
    "description": "SoundCreation — musical instruments and audio equipment. Programmatic catalog access for AI shopping agents: search, product lookup, and an MCP server.",
    "provider": {
        "legal_name": "Media Crusher SRL",
        "vat_id": "RO18640363",
        "homepage": "https://www.soundcreation.ro/"
    },
    "languages": [
        "ro",
        "hu",
        "de",
        "en"
    ],
    "default_language": "ro",
    "default_currency": "RON",
    "prices_include_vat": true,
    "catalog": {
        "search": {
            "method": "GET",
            "url": "https://www.soundcreation.ro/api/agent/search.php",
            "description": "Free-text search, filtered browse, or both. A query is optional if at least one filter is given. Prices include VAT in the language's currency.",
            "params": {
                "q": "search text (optional when filtering)",
                "lang": "ro|hu|de|en",
                "category_id": "category id (returned on every result)",
                "category": "category name, partial match",
                "brand": "brand name, partial match",
                "min_price": "lowest price, in the response currency",
                "max_price": "highest price, in the response currency",
                "in_stock": "1 = only items in stock now",
                "on_promo": "1 = only discounted items",
                "condition": "new (default) | open_box",
                "sort": "relevance|price_asc|price_desc|discount|newest",
                "limit": "1-50",
                "offset": "0-500"
            },
            "example": "https://www.soundcreation.ro/api/agent/search.php?q=chitara&max_price=2000&in_stock=1&sort=price_asc&lang=ro"
        },
        "product": {
            "method": "GET",
            "url": "https://www.soundcreation.ro/api/agent/product.php",
            "description": "One product with description, specs, stock and VAT-included localized price. When it is NOT in stock the record carries substitutes[]: up to 5 in-stock products of the same kind in the same price band (the same alternatives the product page shows), each as a brief record with its own product_id, price and product_url. Every record also carries companions[]: up to 8 in-stock accessories used together with the product, one per role (role is a short label such as stand, cable, strings, case) - the list our add-to-cart box shows - each as a brief record with its own product_id, price and product_url.",
            "params": {
                "id": "product id",
                "lang": "ro|hu|de|en"
            },
            "example": "https://www.soundcreation.ro/api/agent/product.php?id=1402&lang=ro"
        },
        "promotions": {
            "method": "GET",
            "url": "https://www.soundcreation.ro/api/agent/promotions.php",
            "description": "Everything discounted right now, biggest reduction first. Each result carries price (current) and price_old (before the discount).",
            "params": {
                "lang": "ro|hu|de|en",
                "category_id": "category id",
                "category": "category name",
                "brand": "brand name",
                "in_stock": "1 = in stock only",
                "min_price": "response currency",
                "max_price": "response currency",
                "sort": "discount|price_asc|price_desc|newest",
                "limit": "1-50",
                "offset": "0-500"
            },
            "example": "https://www.soundcreation.ro/api/agent/promotions.php?lang=ro&limit=20"
        },
        "open_box": {
            "method": "GET",
            "url": "https://www.soundcreation.ro/api/agent/open_box.php",
            "description": "Open-box / ex-display units (Romanian: \"resigilat\") — one entry per physical unit, each with its own reduced price, condition note and product page. Small, often one-of-a-kind quantities. Not part of the normal catalog listings and not present in the bulk feed.",
            "params": {
                "lang": "ro|hu|de|en",
                "q": "text match on product or brand",
                "category_id": "category id",
                "category": "category name",
                "brand": "brand name",
                "max_price": "response currency",
                "sort": "discount|price_asc|price_desc|newest",
                "limit": "1-50",
                "offset": "0-500"
            },
            "example": "https://www.soundcreation.ro/api/agent/open_box.php?lang=ro&limit=20"
        },
        "bundles": {
            "method": "GET",
            "url": "https://www.soundcreation.ro/api/agent/bundles.php",
            "description": "Pre-priced sets sold together for less than their parts — an instrument plus the accessories normally needed with it. Each result gives the set price, what the parts cost separately, the saving, and what is included.",
            "params": {
                "lang": "ro|hu|de|en",
                "q": "text match on set or brand name",
                "brand": "brand name",
                "min_price": "response currency",
                "max_price": "response currency",
                "in_stock": "1 = only sets where every item is in stock",
                "sort": "discount|price_asc|price_desc|newest",
                "limit": "1-50",
                "offset": "0-500"
            },
            "example": "https://www.soundcreation.ro/api/agent/bundles.php?lang=ro&limit=20"
        },
        "bulk_feed": {
            "description": "Full product catalog as NDJSON (per-language), rebuilt daily with an hourly changes-only file. Use the live endpoints above for prices, stock, promotions, bundles and open-box units — the feed is a snapshot and carries neither the open-box stock nor the bundles.",
            "manifest": "https://www.soundcreation.ro/ai/manifest.json"
        }
    },
    "mcp": {
        "transport": "http",
        "url": "https://www.soundcreation.ro/api/agent/mcp.php",
        "description": "Model Context Protocol server, JSON-RPC 2.0 over HTTP POST. No account or key needed for the read tools.",
        "tools": [
            "search_products",
            "list_promotions",
            "list_open_box",
            "list_bundles",
            "get_product",
            "compare_products",
            "create_checkout"
        ],
        "setup_guide": "https://www.soundcreation.ro/api/agent/setup.md"
    },
    "llms_txt": "https://www.soundcreation.ro/llms.txt",
    "privacy_policy": "https://www.soundcreation.ro/api/agent/privacy.html",
    "checkout": {
        "status": "available",
        "method": "POST",
        "url": "https://www.soundcreation.ro/api/agent/checkout_sessions.php",
        "auth": "X-Api-Key header — request a key from the operator",
        "markets": [
            "RO",
            "HU",
            "DE"
        ],
        "note": "Creates an order and returns a Stripe payment link; GET ?id={session_id} to poll status."
    },
    "license": "CC-BY-4.0",
    "license_url": "https://creativecommons.org/licenses/by/4.0/"
}