Loading ToolBench
Read-only MCP server for IKEA product search and in-store stock lookup. Supports stdio and Streamable HTTP transports.
ikea-mcp demonstrates solid tool design with consistent naming (verb_noun pattern), comprehensive input schemas using Zod validation, and clear parameter descriptions. All 9 tools have explicit descriptions and well-structured schemas. However, output schemas are not documented, LLMs cannot predict response structure. Error handling lacks recovery guidance. Tool descriptions average ~120 chars (within baseline 194), but lack dependency hints and 'when to use' context. No tool annotations (readOnlyHint, idempotentHint) despite all being read-only operations.
Check whether all items in a shopping list are available in sufficient quantity at a single IKEA store.
Check cash-and-carry stock for multiple items at a single IKEA store.
Check stock availability for an item at a specific IKEA store.
Compare stock availability for an item across multiple IKEA stores. Provide explicit storeIds, or use countryCode ('US' or 'CA') to compare all catalog stores for that country.
Find the best store to buy multiple items in one trip. Ranks stores by how many cart items are available in sufficient quantity, then by total in-stock sum. Optionally filter by countryCode ('US' or 'CA'). Explicit storeIds take precedence over countryCode.
Find stores with the highest in-stock quantity for an item. Returns up to maxResults stores sorted by quantity descending. Optionally filter by countryCode ('US' or 'CA'). Explicit storeIds take precedence over countryCode.
Output schemas not documented. LLMs cannot predict response structure, forcing them to guess what fields are returned and how to chain tools.
Tool descriptions lack 'when to use' context and dependency hints. E.g., search_products should note 'Use this to find item numbers before calling check_store_stock'.
No tool annotations despite all tools being read-only. Missing readOnlyHint would help agents understand these are safe to call without side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Get details for a single IKEA product by item number.
List known IKEA store IDs and display names. Use countryCode ('US' or 'CA') to filter by country, or omit to return all stores.
Search IKEA products by keyword.
Error handling does not guide recovery. No indication of what to do if a store ID is invalid, item not found, or API fails.
Parameter descriptions lack format/constraint details. E.g., 'countryCode' description should state 'Must be 2-letter ISO code (US or CA)' rather than relying on enum alone.