Toys Hub

Official7 tools

by toyshub

Browse Toys Hub: products, prices in ALL, stock, delivery and checkout links. Read-only, no sign-in.

MCP Server: al.toyshub/catalog

The al.toyshub/catalog MCP server provides read-only browsing for Toys Hub content. It supports discovering products and their associated details, including prices in ALL, stock, and delivery and checkout links. No user sign-in is required.

🛠️ Key Features

Browse products
Display prices in ALL
Show stock
Provide delivery and checkout links
Read-only operation
No sign-in required

🚀 Use Cases

Checking product availability and stock levels
Viewing product pricing in ALL
Accessing delivery and checkout destinations from the catalog

⚡ Developer Benefits

Integrates catalog browsing without authentication
Consumable for applications that need product, pricing, stock, and link metadata

Captured live from the server via tools/list.

search_products

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.

Parameters7

query	string	optional	Words to look for in names and descriptions (Albanian or English). Empty lists popular products.
category	string	optional	Category slug from list_categories.
age	integer	optional	Child's age in years; returns products suitable for that age.
max_price	number	optional	Highest price, in the store currency.
in_stock_only	boolean	optional
limit	integer	optional
lang	string	optional	Language of names, descriptions and links: "sq" Albanian, "en" English.

Raw schema

{
  "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
}

get_product

Everything about one product: description, price, availability, age range, brand, photos, rating, delivery and payment facts, and a buy-now link.

Parameters2

slug	string	required	Product slug (from search_products).
lang	string	optional	Language of names, descriptions and links: "sq" Albanian, "en" English.

Raw schema

{
  "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
}

list_categories

All product categories with their slug, name, product count and page.

Parameters1

lang

string

optional

Language of names, descriptions and links: "sq" Albanian, "en" English.

Raw schema

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "sq",
        "en"
      ],
      "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
      "default": "en"
    }
  },
  "additionalProperties": false
}

get_store_info

Who the store is and how buying works: delivery countries, cost and time, payment methods, returns, currency, languages and contact.

Parameters1

lang

string

optional

Language of names, descriptions and links: "sq" Albanian, "en" English.

Raw schema

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "sq",
        "en"
      ],
      "description": "Language of names, descriptions and links: \"sq\" Albanian, \"en\" English.",
      "default": "en"
    }
  },
  "additionalProperties": false
}

check_availability

Whether a product can be ordered now in the wanted quantity.

Parameters2

slug	string	required
quantity	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99,
      "default": 1
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_shipping_quote

Delivery cost and time for a city, and whether the order qualifies for free delivery.

Parameters2

city	string	optional	Delivery city, e.g. Tirana or Prishtina.
order_total	number	optional	Value of the products, in the store currency.

Raw schema

{
  "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
}

create_cart_link

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.

Parameters2

items	array	required
lang	string	optional	Language of names, descriptions and links: "sq" Albanian, "en" English.

Raw schema

{
  "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
}

Install

Tools (7)

search_productsget_productlist_categoriesget_store_infocheck_availabilityget_shipping_quotecreate_cart_link

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://toyshub.al/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "catalog": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://toyshub.al/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: al.toyshub/catalog

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

search_products

get_product

list_categories

get_store_info

check_availability

get_shipping_quote

create_cart_link

Install

Remote endpoint

Related servers