{
    "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
    "version": "1.0",
    "protocolVersion": "2026-07-28",
    "supportedVersions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26",
        "2024-11-05"
    ],
    "serverInfo": {
        "name": "toyshub.al",
        "title": "Toys Hub",
        "version": "2.0.0"
    },
    "description": "Browse Toys Hub: products, prices in ALL, stock, delivery and checkout links. Read-only, no sign-in.",
    "iconUrl": "https://toyshub.al/logo512.png",
    "websiteUrl": "https://toyshub.al/",
    "documentationUrl": "https://toyshub.al/llms.txt",
    "transport": {
        "type": "streamable-http",
        "url": "https://toyshub.al/mcp"
    },
    "remotes": [
        {
            "type": "streamable-http",
            "url": "https://toyshub.al/mcp"
        }
    ],
    "authentication": {
        "required": false
    },
    "capabilities": {
        "tools": {
            "listChanged": false
        }
    },
    "tools": [
        {
            "name": "search_products",
            "title": "Search products",
            "description": "Search Toys Hub's catalogue by words, category, age and price. Returns name, price, availability, photo, product page and a buy-now link for each match.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "Words to look for in names and descriptions (Albanian or English). Empty lists popular products."
                    },
                    "category": {
                        "type": "string",
                        "description": "Category slug from list_categories."
                    },
                    "age": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 18,
                        "description": "Child's age in years; returns products suitable for that age."
                    },
                    "max_price": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Highest price, in the store currency."
                    },
                    "in_stock_only": {
                        "type": "boolean",
                        "default": false
                    },
                    "limit": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 50,
                        "default": 10
                    },
                    "lang": {
                        "type": "string",
                        "enum": [
                            "sq",
                            "en"
                        ],
                        "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            }
        },
        {
            "name": "get_product",
            "title": "Product details",
            "description": "Everything about one product: description, price, availability, age range, brand, photos, rating, delivery and payment facts, and a buy-now link.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "slug": {
                        "type": "string",
                        "description": "Product slug (from search_products)."
                    },
                    "lang": {
                        "type": "string",
                        "enum": [
                            "sq",
                            "en"
                        ],
                        "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
                        "default": "en"
                    }
                },
                "required": [
                    "slug"
                ],
                "additionalProperties": false
            }
        },
        {
            "name": "list_categories",
            "title": "Categories",
            "description": "All product categories with their slug, name, product count and page.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "lang": {
                        "type": "string",
                        "enum": [
                            "sq",
                            "en"
                        ],
                        "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            }
        },
        {
            "name": "get_store_info",
            "title": "Store information",
            "description": "Who the store is and how buying works: delivery countries, cost and time, payment methods, returns, currency, languages and contact.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "lang": {
                        "type": "string",
                        "enum": [
                            "sq",
                            "en"
                        ],
                        "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
                        "default": "en"
                    }
                },
                "additionalProperties": false
            }
        },
        {
            "name": "check_availability",
            "title": "Check availability",
            "description": "Whether a product can be ordered now in the wanted quantity.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "slug": {
                        "type": "string"
                    },
                    "quantity": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 99,
                        "default": 1
                    }
                },
                "required": [
                    "slug"
                ],
                "additionalProperties": false
            }
        },
        {
            "name": "get_shipping_quote",
            "title": "Delivery cost",
            "description": "Delivery cost and time for a city, and whether the order qualifies for free delivery.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "Delivery city, e.g. Tirana or Prishtina."
                    },
                    "order_total": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Value of the products, in the store currency."
                    }
                },
                "additionalProperties": false
            }
        },
        {
            "name": "create_cart_link",
            "title": "Checkout link",
            "description": "Make a link that opens Toys Hub's checkout with these products already in the cart. Give it to the shopper; they confirm and pay on the store's site. Nothing is ordered or stored by this tool.",
            "annotations": {
                "readOnlyHint": true,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false
            },
            "inputSchema": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 20,
                        "items": {
                            "type": "object",
                            "properties": {
                                "slug": {
                                    "type": "string"
                                },
                                "quantity": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 20,
                                    "default": 1
                                }
                            },
                            "required": [
                                "slug"
                            ],
                            "additionalProperties": false
                        }
                    },
                    "lang": {
                        "type": "string",
                        "enum": [
                            "sq",
                            "en"
                        ],
                        "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
                        "default": "en"
                    }
                },
                "required": [
                    "items"
                ],
                "additionalProperties": false
            }
        }
    ]
}