About Toyshub
Toyshub is a read-only MCP server for browsing the Toys Hub catalogue, with product search, prices, stock, and product details in Albanian or English. It serves AI clients looking up toys and store information for Albania and Kosovo.
Key features
- 01Search products by keyword or category
- 02Check prices and stock
- 03Retrieve product descriptions and age ranges
- 04Browse categories and product counts
- 05Look up delivery and payment information
Use cases
- 01Find toys matching a gift request
- 02Check a product's price and availability
- 03Find the right category for a catalogue search
- 04Answer questions about delivery or payment
MCP support
The remote MCP server exposes four read-only tools for product search, product details, categories, and store information. MCP clients connect over HTTPS without authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://toyshub.al/mcpclaude mcp add --transport http toyshub https://toyshub.al/mcp{"mcpServers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}Open in Cursor{"servers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}Open in VS Code{"mcpServers":{"toyshub":{"type":"http","url":"https://toyshub.al/mcp"}}}{"mcpServers":{"toyshub":{"serverUrl":"https://toyshub.al/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Free-text search across product name + description (Albanian or English). |
| category | string | No | Optional category slug (e.g. "water-outdoor", "home-recreation"). Call list_categories first for valid values. |
| limit | integer | No | Maximum number of results to return. Default 10, hard cap 50. |
| lang | enum | No | Language for product names and descriptions. "sq" = Albanian, "en" = English.sq | en |
Details
From the project READMEToys Hub MCP Server
Read-only Model Context Protocol server for the Toys Hub online toy catalogue (toyshub.al) — the leading online toy store in Albania and Kosovo.
Lets AI clients like Claude Desktop, Cursor, Continue, Cline, Windsurf, and ChatGPT deep-research browse our live inventory, check prices in Albanian Lek (ALL), and look up product details in Albanian or English.
No installation, no API key. The server runs at
https://toyshub.al/mcpover plain HTTPS — just point your MCP client at the URL.
Install
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"toyshub": {
"url": "https://toyshub.al/mcp"
}
}
}
Restart Claude Desktop. You'll see the 🔌 indicator next to the message box.
Cursor / Continue / Cline / Windsurf
Most MCP-capable IDEs accept the same URL-style config. Refer to your client's "Add MCP server" UI and paste:
https://toyshub.al/mcp
Transport: HTTP (POST JSON-RPC 2.0). No auth.
Quick test from the terminal
curl -X POST https://toyshub.al/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Tools
| Tool | Description |
|---|---|
search_products(query, category?, limit?, lang?) | Search the catalogue by keyword and/or category. Returns up to 50 products with name, price, stock, image, URL. Bilingual: pass lang: "sq" for Albanian, lang: "en" (default) for English. |
get_product(slug, lang?) | Fetch full PDP data: description, SKU, stock status, all images, tags, recommended age range. Slug comes from the url returned by search_products. |
list_categories(lang?) | All product categories with their slug, name, and product count. Call this first to discover valid category values for search_products. |
get_store_info() | Static facts: currency, delivery areas (Albania + Kosovo), payment methods, business hours, contact email. Use for shipping / returns / contact questions. |
Example: agent searching for a gift
User: "Find a magnetic building toy for a 6-year-old, under 7000 lek"
Agent calls search_products(query: "magnetic", limit: 5)
→ 3 results with prices 2,800 / 6,600 / 7,200 ALL
Agent calls get_product(slug: "magnetic-blocks-129pcs", lang: "en")
→ ageMin: 3, ageMax: 10, price: 6,600 — fits the brief.
Agent replies: "Magnetic blocks 129pcs at 6,600 ALL fits perfectly —
ages 3-10, in stock. https://toyshub.al/products/magnetic-blocks-129pcs"
About Toys Hub
- Website: toyshub.al
- Delivery: Albania & Kosovo
- Currency: Albanian Lek (ALL)
- Payment: Cash on delivery, credit/debit card
- Languages: Albanian (sq), English (en)
- Contact: [email protected]
Implementation
The server is implemented as a Symfony controller co-located with the Toys Hub e-commerce backend — the source for the actual handler is private, but the interface (this repo) and the live endpoint (/mcp) are public and stable.
It implements the MCP 2024-11-05 specification including initialize, tools/list, tools/call, and ping. Errors follow the standard JSON-RPC 2.0 error codes (-32600 through -32603). CORS is permissive (Access-Control-Allow-Origin: *) because all four tools are read-only with no cookies attached.
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.