ikea-mcp 1.6.2 → 1.10.0

package/dist/data/countries.js

@@ -0,0 +1,16 @@
+// Supported countries for the stock tools and the store catalog.
+// Adding a country: add it here, add its stores to ./stores.ts, add README rows.
+export const COUNTRY_CODES = ["US", "CA", "NO"];
+/** Default language for the IKEA search API when the client does not pass langCode. */
+export const DEFAULT_LANG_CODE = {
+    US: "en",
+    CA: "en",
+    NO: "no",
+};
+export function isCountryCode(value) {
+    return COUNTRY_CODES.includes(value);
+}
+/** Default search language for a country; "en" for countries outside the catalog. */
+export function defaultLangCode(countryCode) {
+    return isCountryCode(countryCode) ? DEFAULT_LANG_CODE[countryCode] : "en";
+}

package/dist/data/geo.js

@@ -0,0 +1,26 @@
+import { STORES } from "./stores.js";
+import { STORE_COORDINATES } from "./store-coordinates.js";
+const EARTH_RADIUS_KM = 6371;
+const toRad = (deg) => (deg * Math.PI) / 180;
+/** Great-circle distance in kilometres (haversine). */
+export function distanceKm(a, b) {
+    const dLat = toRad(b.lat - a.lat);
+    const dLon = toRad(b.lon - a.lon);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(a.lat)) * Math.cos(toRad(b.lat)) * Math.sin(dLon / 2) ** 2;
+    return 2 * EARTH_RADIUS_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+/**
+ * Catalog stores closest to a point, nearest first; ties break on storeId.
+ * Stores without a known coordinate are left out rather than placed by guess.
+ */
+export function nearestStores(from, options) {
+    return STORES.filter((s) => !options.countryCode || s.countryCode === options.countryCode)
+        .flatMap((s) => {
+        const at = STORE_COORDINATES[s.storeId];
+        return at ? [{ storeId: s.storeId, countryCode: s.countryCode, km: distanceKm(from, at) }] : [];
+    })
+        .filter((s) => options.maxDistanceKm === undefined || s.km <= options.maxDistanceKm)
+        .sort((a, b) => a.km - b.km || a.storeId.localeCompare(b.storeId))
+        .slice(0, options.limit)
+        .map(({ storeId, countryCode, km }) => ({ storeId, countryCode, distanceKm: Math.round(km * 10) / 10 }));
+}

package/dist/data/store-coordinates.js

@@ -0,0 +1,88 @@
+// Generated by scripts/update-store-coordinates.mjs from IKEA's public store lists
+// (ikea.com/<country>/<lang>/meta-data/informera/stores-detailed.json). Do not edit by hand.
+// A catalog store that is missing here is left out of distance searches, not guessed.
+export const STORE_COORDINATES = {
+    "026": { lat: 42.3252, lon: -83.4516 }, // IKEA Detroit - Canton
+    "027": { lat: 30.5569, lon: -97.6897 }, // IKEA Austin - Round Rock
+    "028": { lat: 45.5712, lon: -122.5537 }, // IKEA Oregon - Portland
+    "042": { lat: 27.9541, lon: -82.4327 }, // IKEA Tampa
+    "064": { lat: 39.5720, lon: -104.8749 }, // IKEA Denver - Centennial
+    "067": { lat: 35.2930, lon: -80.7642 }, // IKEA Charlotte
+    "103": { lat: 40.5083, lon: -111.8922 }, // IKEA Salt Lake City - Draper
+    "145": { lat: 28.4830, lon: -81.4273 }, // IKEA Orlando
+    "152": { lat: 39.3747, lon: -76.4623 }, // IKEA Baltimore
+    "153": { lat: 40.4522, lon: -80.1676 }, // IKEA Pittsburg
+    "154": { lat: 40.6751, lon: -74.1697 }, // IKEA New York - Elizabeth
+    "156": { lat: 40.7744, lon: -73.5315 }, // IKEA New York - Long Island
+    "157": { lat: 38.5866, lon: -121.5535 }, // IKEA Sacramento - West Sacramento
+    "158": { lat: 42.1367, lon: -71.0687 }, // IKEA Boston - Stoughton
+    "162": { lat: 33.8419, lon: -118.2601 }, // IKEA Los Angeles - Carson
+    "165": { lat: 37.8312, lon: -122.2925 }, // IKEA San Francisco - Emeryville
+    "166": { lat: 32.7800, lon: -117.1264 }, // IKEA San Diego
+    "167": { lat: 33.6905, lon: -117.9163 }, // IKEA Los Angeles - Costa Mesa
+    "168": { lat: 38.6431, lon: -77.2901 }, // IKEA Washington - Woodbridge
+    "170": { lat: 41.7274, lon: -88.0379 }, // IKEA Chicago - Bolingbrook
+    "175": { lat: 39.3160, lon: -84.4353 }, // IKEA Cincinnati - West Chester
+    "183": { lat: 33.0951, lon: -96.8216 }, // IKEA Dallas - Frisco
+    "207": { lat: 26.1215, lon: -80.3319 }, // IKEA Fort Lauderdale - Sunrise
+    "209": { lat: 33.3406, lon: -111.9702 }, // IKEA Phoenix - Tempe
+    "210": { lat: 42.0567, lon: -88.0353 }, // IKEA Chicago - Schaumburg
+    "211": { lat: 40.0942, lon: -75.3079 }, // IKEA Philadelphia - Conshohocken
+    "212": { lat: 44.8590, lon: -93.2435 }, // IKEA Minneapolis - Bloomington
+    "213": { lat: 41.2950, lon: -72.9192 }, // IKEA New York - New Haven
+    "215": { lat: 39.9167, lon: -75.1401 }, // IKEA Philadelphia - Penn S Landing
+    "257": { lat: 33.7878, lon: -84.4062 }, // IKEA Atlanta
+    "327": { lat: 25.7916, lon: -80.3834 }, // IKEA Miami
+    "347": { lat: 37.4609, lon: -122.1390 }, // IKEA San Francisco - East Palo Alto
+    "374": { lat: 39.0199, lon: -94.6906 }, // IKEA Kansas City - Merriam
+    "379": { lat: 29.7855, lon: -95.4723 }, // IKEA Houston
+    "399": { lat: 34.1745, lon: -118.3032 }, // IKEA Los Angeles - Burbank
+    "409": { lat: 40.9246, lon: -74.0749 }, // IKEA New York - Paramus
+    "410": { lat: 38.6337, lon: -90.2449 }, // IKEA Missouri - St. Louis
+    "411": { lat: 39.0208, lon: -76.9289 }, // IKEA Washington - College Park
+    "413": { lat: 34.0744, lon: -117.8801 }, // IKEA Los Angeles - Covina
+    "462": { lat: 36.0688, lon: -115.2811 }, // IKEA Las Vegas
+    "488": { lat: 47.4424, lon: -122.2278 }, // IKEA Seattle - Renton
+    "511": { lat: 40.1507, lon: -82.9671 }, // IKEA Columbus
+    "535": { lat: 32.6908, lon: -97.0227 }, // IKEA Dallas - Grand Prairie
+    "536": { lat: 39.9537, lon: -86.0059 }, // IKEA Indianapolis - Fishers
+    "537": { lat: 30.2366, lon: -81.5185 }, // IKEA Jacksonville
+    "560": { lat: 42.9079, lon: -87.9387 }, // IKEA Milwaukee - Oak Creek
+    "569": { lat: 36.8763, lon: -76.2014 }, // IKEA Norfolk
+    "570": { lat: 29.5667, lon: -98.3381 }, // IKEA San Antonio - Live Oak
+    "658": { lat: 37.7828, lon: -122.4088 }, // IKEA San Francisco - Market Street
+    "921": { lat: 40.6720, lon: -74.0115 }, // IKEA New York - Brooklyn
+    "1013": { lat: 32.9180, lon: -96.4265 }, // IKEA Dallas - Rockwall
+    "1099": { lat: 32.8695, lon: -96.7689 }, // IKEA Dallas - University Park
+    "1100": { lat: 26.2042, lon: -98.2016 }, // IKEA McAllen Pharr - Town Center
+    "1129": { lat: 43.0686, lon: -76.1743 }, // IKEA Syracuse - Destiny Mall
+    "1130": { lat: 38.8881, lon: -77.4399 }, // IKEA Washington - Chantilly
+    "1132": { lat: 33.5998, lon: -111.9837 }, // IKEA Phoenix - Scottsdale
+    "1232": { lat: 34.7415, lon: -86.6762 }, // IKEA Huntsville - University Place
+    "1253": { lat: 29.5385, lon: -95.1360 }, // IKEA Webster - Bay Area
+    "1284": { lat: 34.0307, lon: -118.3848 }, // IKEA Los Angeles - Culver City
+    "1309": { lat: 36.0574, lon: -96.0012 }, // IKEA Tulsa - Tulsa Hills
+    "003": { lat: 49.1899, lon: -123.0797 }, // IKEA Vancouver - Richmond
+    "004": { lat: 45.3503, lon: -75.7841 }, // IKEA Ottawa
+    "039": { lat: 45.4912, lon: -73.6908 }, // IKEA Montreal - Ville St. Laurent
+    "040": { lat: 43.3279, lon: -79.8292 }, // IKEA Toronto - Burlington
+    "149": { lat: 43.7676, lon: -79.3693 }, // IKEA Toronto - North York
+    "216": { lat: 50.9799, lon: -114.0448 }, // IKEA Calgary
+    "249": { lat: 49.8389, lon: -97.2104 }, // IKEA Winnipeg
+    "256": { lat: 43.6190, lon: -79.5350 }, // IKEA Toronto - Etobicoke
+    "313": { lat: 49.2351, lon: -122.8658 }, // IKEA Vancouver - Coquitlam
+    "349": { lat: 53.4432, lon: -113.4897 }, // IKEA South Edmonton
+    "372": { lat: 43.7877, lon: -79.5296 }, // IKEA Toronto - Vaughan
+    "414": { lat: 45.5716, lon: -73.4007 }, // IKEA Montreal - Boucherville
+    "529": { lat: 44.7130, lon: -63.5575 }, // IKEA Halifax - Nova Scotia
+    "559": { lat: 46.7766, lon: -71.3495 }, // IKEA Quebec City
+    "659": { lat: 43.6597, lon: -79.3830 }, // IKEA Toronto - Downtown
+    "1340": { lat: 42.9308, lon: -81.2229 }, // IKEA London - White Oak Mall
+    "007": { lat: 58.1873, lon: 8.1584 }, // IKEA Kristiansand - Sørlandet
+    "091": { lat: 59.8739, lon: 10.4974 }, // IKEA Oslo - Slependen
+    "095": { lat: 59.9338, lon: 10.8731 }, // IKEA Oslo - Furuset
+    "126": { lat: 58.8867, lon: 5.7212 }, // IKEA Stavanger - Forus
+    "371": { lat: 63.4286, lon: 10.4738 }, // IKEA Trondheim - Leangen
+    "390": { lat: 60.8402, lon: 11.0575 }, // IKEA Hamar - Ringsaker
+    "441": { lat: 60.4761, lon: 5.3320 }, // IKEA Bergen - Åsane
+};

package/dist/data/stores.js

@@ -1,93 +1,122 @@
-// US store labels confirmed from ikea.com/us/en/stores/<slug>/ pages (store_id= survey param).
-// CA store labels confirmed from ikea.com/ca/en/stores/<slug>/ pages (storeNo= embedded JSON).
-// IDs match the sto/{storeId} path used by the IKEA stock API.
-// 4-digit IDs (921, 1099, 1129) are newer-format stores — confirmed working with stock API.
-// 3136 (San Francisco) returns 405 from stock API — excluded.
-// 698 (CA — unknown city) returns 422 from stock API — excluded.
-// 659 (Toronto Downtown) returns 200 but null quantity — included conservatively.
-// TODO: huntsville, arcadia, mcallen-pharr, san-marcos (US) — IDs not found on store pages.
-// TODO: 448, 612, 634, 652, 661, 663, 692, 693 — valid API IDs, city/country unknown.
-export const STORE_LABELS = {
+export const STORES = [
     // ── United States ────────────────────────────────────────────────────────────
-    "026": "026 (Canton, MI)",
-    "027": "027 (Round Rock, TX)",
-    "028": "028 (Portland, OR)",
-    "042": "042 (Tampa, FL)",
-    "064": "064 (Centennial, CO)",
-    "067": "067 (Charlotte, NC)",
-    "103": "103 (Draper, UT)",
-    "145": "145 (Orlando, FL)",
-    "152": "152 (Baltimore, MD)",
-    "153": "153 (Pittsburgh, PA)",
-    "154": "154 (Elizabeth, NJ)",
-    "156": "156 (Long Island, NY)",
-    "157": "157 (West Sacramento, CA)",
-    "158": "158 (Stoughton, MA)",
-    "162": "162 (Carson, CA)",
-    "165": "165 (Emeryville, CA)",
-    "166": "166 (San Diego, CA)",
-    "167": "167 (Costa Mesa, CA)",
-    "168": "168 (Woodbridge, VA)",
-    "170": "170 (Bolingbrook, IL)",
-    "175": "175 (West Chester, OH)",
-    "183": "183 (Frisco, TX)",
-    "207": "207 (Sunrise, FL)",
-    "209": "209 (Tempe, AZ)",
-    "210": "210 (Schaumburg, IL)",
-    "211": "211 (Conshohocken, PA)",
-    "212": "212 (Minneapolis, MN)",
-    "213": "213 (New Haven, CT)",
-    "215": "215 (South Philadelphia, PA)",
-    "257": "257 (Atlanta, GA)",
-    "327": "327 (Miami, FL)",
-    "347": "347 (East Palo Alto, CA)",
-    "374": "374 (Merriam, KS)",
-    "379": "379 (Houston, TX)",
-    "399": "399 (Burbank, CA)",
-    "409": "409 (Paramus, NJ)",
-    "410": "410 (St. Louis, MO)",
-    "411": "411 (College Park, MD)",
-    "413": "413 (Covina, CA)",
-    "462": "462 (Las Vegas, NV)",
-    "488": "488 (Renton, WA)",
-    "508": "508 (Memphis, TN)",
-    "511": "511 (Columbus, OH)",
-    "535": "535 (Grand Prairie, TX)",
-    "536": "536 (Fishers, IN)",
-    "537": "537 (Jacksonville, FL)",
-    "560": "560 (Oak Creek, WI)",
-    "569": "569 (Norfolk, VA)",
-    "570": "570 (Live Oak, TX)",
-    "921": "921 (Brooklyn, NY)",
-    "1099": "1099 (University Park, TX)",
-    "1129": "1129 (Syracuse, NY)",
+    { storeId: "026", city: "Canton", region: "MI", countryCode: "US" },
+    { storeId: "027", city: "Round Rock", region: "TX", countryCode: "US" },
+    { storeId: "028", city: "Portland", region: "OR", countryCode: "US" },
+    { storeId: "042", city: "Tampa", region: "FL", countryCode: "US" },
+    { storeId: "064", city: "Centennial", region: "CO", countryCode: "US" },
+    { storeId: "067", city: "Charlotte", region: "NC", countryCode: "US" },
+    { storeId: "103", city: "Draper", region: "UT", countryCode: "US" },
+    { storeId: "145", city: "Orlando", region: "FL", countryCode: "US" },
+    { storeId: "152", city: "Baltimore", region: "MD", countryCode: "US" },
+    { storeId: "153", city: "Pittsburgh", region: "PA", countryCode: "US" },
+    { storeId: "154", city: "Elizabeth", region: "NJ", countryCode: "US" },
+    { storeId: "156", city: "Long Island", region: "NY", countryCode: "US" },
+    { storeId: "157", city: "West Sacramento", region: "CA", countryCode: "US" },
+    { storeId: "158", city: "Stoughton", region: "MA", countryCode: "US" },
+    { storeId: "162", city: "Carson", region: "CA", countryCode: "US" },
+    { storeId: "165", city: "Emeryville", region: "CA", countryCode: "US" },
+    { storeId: "166", city: "San Diego", region: "CA", countryCode: "US" },
+    { storeId: "167", city: "Costa Mesa", region: "CA", countryCode: "US" },
+    { storeId: "168", city: "Woodbridge", region: "VA", countryCode: "US" },
+    { storeId: "170", city: "Bolingbrook", region: "IL", countryCode: "US" },
+    { storeId: "175", city: "West Chester", region: "OH", countryCode: "US" },
+    { storeId: "183", city: "Frisco", region: "TX", countryCode: "US" },
+    { storeId: "207", city: "Sunrise", region: "FL", countryCode: "US" },
+    { storeId: "209", city: "Tempe", region: "AZ", countryCode: "US" },
+    { storeId: "210", city: "Schaumburg", region: "IL", countryCode: "US" },
+    { storeId: "211", city: "Conshohocken", region: "PA", countryCode: "US" },
+    { storeId: "212", city: "Minneapolis", region: "MN", countryCode: "US" },
+    { storeId: "213", city: "New Haven", region: "CT", countryCode: "US" },
+    { storeId: "215", city: "South Philadelphia", region: "PA", countryCode: "US" },
+    { storeId: "257", city: "Atlanta", region: "GA", countryCode: "US" },
+    { storeId: "327", city: "Miami", region: "FL", countryCode: "US" },
+    { storeId: "347", city: "East Palo Alto", region: "CA", countryCode: "US" },
+    { storeId: "374", city: "Merriam", region: "KS", countryCode: "US" },
+    { storeId: "379", city: "Houston", region: "TX", countryCode: "US" },
+    { storeId: "399", city: "Burbank", region: "CA", countryCode: "US" },
+    { storeId: "409", city: "Paramus", region: "NJ", countryCode: "US" },
+    { storeId: "410", city: "St. Louis", region: "MO", countryCode: "US" },
+    { storeId: "411", city: "College Park", region: "MD", countryCode: "US" },
+    { storeId: "413", city: "Covina", region: "CA", countryCode: "US" },
+    { storeId: "462", city: "Las Vegas", region: "NV", countryCode: "US" },
+    { storeId: "488", city: "Renton", region: "WA", countryCode: "US" },
+    { storeId: "511", city: "Columbus", region: "OH", countryCode: "US" },
+    { storeId: "535", city: "Grand Prairie", region: "TX", countryCode: "US" },
+    { storeId: "536", city: "Fishers", region: "IN", countryCode: "US" },
+    { storeId: "537", city: "Jacksonville", region: "FL", countryCode: "US" },
+    { storeId: "560", city: "Oak Creek", region: "WI", countryCode: "US" },
+    { storeId: "569", city: "Norfolk", region: "VA", countryCode: "US" },
+    { storeId: "570", city: "Live Oak", region: "TX", countryCode: "US" },
+    { storeId: "658", city: "San Francisco", region: "CA", countryCode: "US" },
+    { storeId: "921", city: "Brooklyn", region: "NY", countryCode: "US" },
+    { storeId: "1013", city: "Rockwall", region: "TX", countryCode: "US" },
+    { storeId: "1099", city: "University Park", region: "TX", countryCode: "US" },
+    { storeId: "1100", city: "Pharr", region: "TX", countryCode: "US" },
+    { storeId: "1129", city: "Syracuse", region: "NY", countryCode: "US" },
+    { storeId: "1130", city: "Chantilly", region: "VA", countryCode: "US" },
+    { storeId: "1132", city: "Scottsdale", region: "AZ", countryCode: "US" },
+    { storeId: "1232", city: "Huntsville", region: "AL", countryCode: "US" },
+    { storeId: "1253", city: "Webster", region: "TX", countryCode: "US" },
+    { storeId: "1284", city: "Culver City", region: "CA", countryCode: "US" },
+    { storeId: "1309", city: "Tulsa", region: "OK", countryCode: "US" },
     // ── Canada ───────────────────────────────────────────────────────────────────
-    // Confirmed from ikea.com/ca/en/stores/<slug>/ pages (storeNo= embedded JSON).
     // All probed against stock API with item 20522046 — all return 200.
-    "003": "003 (Richmond, BC, CA)",
-    "004": "004 (Ottawa, ON, CA)",
-    "039": "039 (Montreal, QC, CA)",
-    "040": "040 (Burlington, ON, CA)",
-    "149": "149 (North York, ON, CA)",
-    "216": "216 (Calgary, AB, CA)",
-    "249": "249 (Winnipeg, MB, CA)",
-    "256": "256 (Etobicoke, ON, CA)",
-    "313": "313 (Coquitlam, BC, CA)",
-    "349": "349 (Edmonton, AB, CA)",
-    "372": "372 (Vaughan, ON, CA)",
-    "414": "414 (Boucherville, QC, CA)",
-    "529": "529 (Halifax, NS, CA)",
-    "559": "559 (Quebec City, QC, CA)",
-    "659": "659 (Toronto Downtown, ON, CA)",
-};
+    { storeId: "003", city: "Richmond", region: "BC", countryCode: "CA" },
+    { storeId: "004", city: "Ottawa", region: "ON", countryCode: "CA" },
+    { storeId: "039", city: "Montreal", region: "QC", countryCode: "CA" },
+    { storeId: "040", city: "Burlington", region: "ON", countryCode: "CA" },
+    { storeId: "149", city: "North York", region: "ON", countryCode: "CA" },
+    { storeId: "216", city: "Calgary", region: "AB", countryCode: "CA" },
+    { storeId: "249", city: "Winnipeg", region: "MB", countryCode: "CA" },
+    { storeId: "256", city: "Etobicoke", region: "ON", countryCode: "CA" },
+    { storeId: "313", city: "Coquitlam", region: "BC", countryCode: "CA" },
+    { storeId: "349", city: "Edmonton", region: "AB", countryCode: "CA" },
+    { storeId: "372", city: "Vaughan", region: "ON", countryCode: "CA" },
+    { storeId: "414", city: "Boucherville", region: "QC", countryCode: "CA" },
+    { storeId: "529", city: "Halifax", region: "NS", countryCode: "CA" },
+    { storeId: "559", city: "Quebec City", region: "QC", countryCode: "CA" },
+    { storeId: "659", city: "Toronto Downtown", region: "ON", countryCode: "CA" },
+    { storeId: "1340", city: "London", region: "ON", countryCode: "CA" },
+    // ── Norway ───────────────────────────────────────────────────────────────────
+    // Full-size stores only. All probed against stock API with item 00263850 — all return 200
+    // with a cash-and-carry quantity. City is the metropolitan area the store is known by.
+    { storeId: "007", name: "Sørlandet", city: "Kristiansand", countryCode: "NO" },
+    { storeId: "091", name: "Slependen", city: "Asker", countryCode: "NO" },
+    { storeId: "095", name: "Furuset", city: "Oslo", countryCode: "NO" },
+    { storeId: "126", name: "Forus", city: "Stavanger", countryCode: "NO" },
+    { storeId: "371", name: "Leangen", city: "Trondheim", countryCode: "NO" },
+    { storeId: "390", name: "Ringsaker", city: "Hamar", countryCode: "NO" },
+    { storeId: "441", name: "Åsane", city: "Bergen", countryCode: "NO" },
+];
+/**
+ * Display label: "<id> (<name>, <city>, <region>, <country>)" with absent parts omitted.
+ * US labels historically carry no country suffix; that quirk is preserved so existing
+ * labels stay byte-identical ("026 (Canton, MI)", "003 (Richmond, BC, CA)", "095 (Furuset, Oslo, NO)").
+ */
+export function storeLabelFor(store) {
+    const parts = [
+        store.name,
+        store.city,
+        store.region,
+        store.countryCode === "US" ? undefined : store.countryCode,
+    ].filter((p) => typeof p === "string" && p.length > 0);
+    return `${store.storeId} (${parts.join(", ")})`;
+}
+const BY_ID = new Map(STORES.map((s) => [s.storeId, s]));
+/** storeId → label. Kept for backward compatibility; prefer storeLabel() / STORES. */
+export const STORE_LABELS = Object.fromEntries(STORES.map((s) => [s.storeId, storeLabelFor(s)]));
 export function storeLabel(storeId) {
-    return STORE_LABELS[storeId];
+    const store = BY_ID.get(storeId);
+    return store ? storeLabelFor(store) : undefined;
+}
+export function storeCountry(storeId) {
+    return BY_ID.get(storeId)?.countryCode;
+}
+/** All catalog store IDs in declaration order (US, CA, NO). */
+export function allStoreIds() {
+    return STORES.map((s) => s.storeId);
 }
-// Canada labels have a province code before the country: "(City, BC, CA)"
-// US state abbreviations like California "(City, CA)" must not match.
-const CA_LABEL_RE = /,\s+[A-Z]{2},\s+CA\)$/;
 export function storeIdsByCountry(countryCode) {
-    return Object.entries(STORE_LABELS)
-        .filter(([, label]) => countryCode === "CA" ? CA_LABEL_RE.test(label) : !CA_LABEL_RE.test(label))
-        .map(([id]) => id);
+    return STORES.filter((s) => s.countryCode === countryCode).map((s) => s.storeId);
 }

package/dist/schemas/index.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { COUNTRY_CODES, defaultLangCode } from "../data/countries.js";
 // ── normalizeItemNo ───────────────────────────────────────────────────────────
 /**
  * Strips non-digit characters, then left-pads to 8 digits when the result is
@@ -27,16 +28,21 @@ const toUpper = (v) => typeof v === "string" ? v.toUpperCase() : v;
 // Free-form 2-letter ISO country code normalised to uppercase.
 // Used by search and product-detail tools that accept any country code.
 const CountryCode2 = z.preprocess(toUpper, z.string().length(2));
-// Uppercase-normalised enum restricted to the two countries supported by the
-// stock-lookup API. Accepts "us"/"ca" and normalises to "US"/"CA".
-const CountryCodeEnum = z.preprocess(toUpper, z.enum(["US", "CA"]));
+// Uppercase-normalised enum restricted to the countries in the store catalog.
+// Accepts "us"/"ca"/"no" and normalises to "US"/"CA"/"NO".
+const CountryCodeEnum = z.preprocess(toUpper, z.enum(COUNTRY_CODES));
+// Two-letter language code for the search API. Optional on input; filled from the
+// country's default (see defaultLangCode) when omitted.
+const LangCode = z.string().length(2);
 // ── Input schemas ─────────────────────────────────────────────────────────────
-export const SearchProductsInput = z.object({
+export const SearchProductsInput = z
+    .object({
     query: z.string().min(1),
     countryCode: CountryCode2.default("US"),
-    langCode: z.string().length(2).default("en"),
+    langCode: LangCode.optional(),
     size: z.number().int().min(1).max(50).default(10),
-});
+})
+    .transform((d) => ({ ...d, langCode: d.langCode ?? defaultLangCode(d.countryCode) }));
 export const CheckStoreStockInput = z.object({
     itemNo: ItemNo,
     storeId: z.string().min(1),
@@ -53,18 +59,45 @@ export const CompareStoreStockInput = z
 export const ListStoresInput = z.object({
     countryCode: CountryCodeEnum.optional(),
 });
-export const FindBestStoreInput = z.object({
+// A point on the map: the user's city or address, in decimal degrees.
+const Near = z.object({
+    latitude: z.number().min(-90).max(90),
+    longitude: z.number().min(-180).max(180),
+});
+const NearestStores = z.number().int().min(1).max(20).default(5);
+// Same rule as FindNearbyStoresInput.maxDistanceKm.
+const MaxDistanceKm = z.number().positive().optional();
+const MAX_DISTANCE_NEEDS_NEAR = "maxDistanceKm needs near";
+// A distance limit only means something for a `near` search; explicit `storeIds` are searched as given, so the limit is ignored there.
+function maxDistanceHasPlace(d) {
+    return d.maxDistanceKm === undefined || d.near !== undefined || d.storeIds !== undefined;
+}
+export const FindNearbyStoresInput = z.object({
+    latitude: z.number().min(-90).max(90),
+    longitude: z.number().min(-180).max(180),
+    countryCode: CountryCodeEnum.optional(),
+    maxResults: z.number().int().min(1).max(20).default(5),
+    maxDistanceKm: z.number().positive().optional(),
+});
+export const FindBestStoreInput = z
+    .object({
     itemNo: ItemNo,
     storeIds: z.array(z.string().min(1)).optional(),
     maxResults: z.number().int().min(1).max(50).default(3),
     countryCode: CountryCodeEnum.optional(),
+    near: Near.optional(),
+    nearestStores: NearestStores,
+    maxDistanceKm: MaxDistanceKm,
     minQuantity: z.number().int().min(1).optional(),
-});
-export const GetProductDetailsInput = z.object({
+})
+    .refine(maxDistanceHasPlace, { message: MAX_DISTANCE_NEEDS_NEAR, path: ["maxDistanceKm"] });
+export const GetProductDetailsInput = z
+    .object({
     itemNo: ItemNo,
     countryCode: CountryCode2.default("US"),
-    langCode: z.string().length(2).default("en"),
-});
+    langCode: LangCode.optional(),
+})
+    .transform((d) => ({ ...d, langCode: d.langCode ?? defaultLangCode(d.countryCode) }));
 export const CheckMultiItemStockInput = z.object({
     storeId: z.string().min(1),
     itemNos: z.array(ItemNo).min(1).max(20),
@@ -76,12 +109,17 @@ export const CheckCartAvailabilityInput = z.object({
         quantity: z.number().int().min(1).max(99).default(1),
     })).min(1).max(20),
 });
-export const FindBestStoreForCartInput = z.object({
+export const FindBestStoreForCartInput = z
+    .object({
     items: z.array(z.object({
         itemNo: ItemNo,
         quantity: z.number().int().min(1).max(99).default(1),
     })).min(1).max(20),
     storeIds: z.array(z.string().min(1)).optional(),
     countryCode: CountryCodeEnum.optional(),
+    near: Near.optional(),
+    nearestStores: NearestStores,
+    maxDistanceKm: MaxDistanceKm,
     maxResults: z.number().int().min(1).max(50).default(3),
-});
+})
+    .refine(maxDistanceHasPlace, { message: MAX_DISTANCE_NEEDS_NEAR, path: ["maxDistanceKm"] });

package/dist/server.js

@@ -1,3 +1,4 @@
+import { createRequire } from "node:module";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { searchProductsTool } from "./tools/search_products.js";
@@ -9,22 +10,58 @@ import { checkMultiItemStockTool } from "./tools/check_multi_item_stock.js";
 import { listStoresTool } from "./tools/list_stores.js";
 import { checkCartAvailabilityTool } from "./tools/check_cart_availability.js";
 import { findBestStoreForCartTool } from "./tools/find_best_store_for_cart.js";
-const tools = [listStoresTool, searchProductsTool, checkStoreStockTool, compareStoreStockTool, findBestStoreForItemTool, getProductDetailsTool, checkMultiItemStockTool, checkCartAvailabilityTool, findBestStoreForCartTool];
-export function createServer() {
-    const server = new Server({ name: "ikea-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: tools.map(({ name, description, inputSchema }) => ({
-            name,
-            description,
-            inputSchema,
-        })),
+import { findNearbyStoresTool } from "./tools/find_nearby_stores.js";
+import { toToolError } from "./utils/errors.js";
+// The version the server reports is the package version, read from package.json next to dist/ (or src/ in dev).
+const { version } = createRequire(import.meta.url)("../package.json");
+const tools = [listStoresTool, findNearbyStoresTool, searchProductsTool, checkStoreStockTool, compareStoreStockTool, findBestStoreForItemTool, getProductDetailsTool, checkMultiItemStockTool, checkCartAvailabilityTool, findBestStoreForCartTool];
+// Every tool only reads. All but the two catalog tools call the live IKEA API, so their answers can change between calls.
+const CATALOG_ONLY = new Set(["list_stores", "find_nearby_stores"]);
+const TITLES = {
+    list_stores: "List IKEA stores",
+    find_nearby_stores: "Find IKEA stores near a place",
+    search_products: "Search IKEA products",
+    get_product_details: "Get IKEA product details",
+    check_store_stock: "Check stock at one store",
+    check_multi_item_stock: "Check several items at one store",
+    compare_store_stock: "Compare stock across stores",
+    find_best_store_for_item: "Find the best store for an item",
+    check_cart_availability: "Check a shopping list at one store",
+    find_best_store_for_cart: "Find the best store for a shopping list",
+};
+export function listTools() {
+    return tools.map(({ name, description, inputSchema }) => ({
+        name,
+        description,
+        inputSchema,
+        annotations: {
+            title: TITLES[name],
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: !CATALOG_ONLY.has(name),
+        },
     }));
-    server.setRequestHandler(CallToolRequestSchema, async (req) => {
-        const tool = tools.find((t) => t.name === req.params.name);
-        if (!tool) {
-            throw new Error(`Unknown tool: ${req.params.name}`);
-        }
-        return tool.handler(req.params.arguments);
-    });
+}
+/**
+ * Runs one tool. An unknown tool name is a protocol error; anything a known tool throws (bad input, an upstream
+ * failure) comes back as a tool result with isError set, so the model can read it and correct the call.
+ */
+export async function callTool(name, args) {
+    const tool = tools.find((t) => t.name === name);
+    if (!tool) {
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    try {
+        return await tool.handler(args);
+    }
+    catch (err) {
+        return toToolError(name, err);
+    }
+}
+export function createServer() {
+    const server = new Server({ name: "ikea-mcp", version }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: listTools() }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => callTool(req.params.name, req.params.arguments));
     return server;
 }

package/dist/services/ikea.js

@@ -14,6 +14,7 @@ export function projectStock(result) {
     const a = result.availabilities?.[0];
     return {
         availableForCashCarry: a?.availableForCashCarry ?? false,
+        inRange: a?.buyingOption?.cashCarry?.range?.inRange ?? null,
         quantity: a?.buyingOption?.cashCarry?.availability?.quantity ?? null,
         messageType: a?.buyingOption?.cashCarry?.availability?.probability?.thisDay?.messageType ?? null,
         eligibleForStockNotification: a?.buyingOption?.cashCarry?.eligibleForStockNotification ?? null,
@@ -38,6 +39,7 @@ export function projectMultiItemStock(result, itemNos) {
             return {
                 itemNo,
                 availableForCashCarry: false,
+                inRange: null,
                 quantity: null,
                 messageType: null,
                 eligibleForStockNotification: null,
@@ -49,6 +51,7 @@ export function projectMultiItemStock(result, itemNos) {
             return {
                 itemNo,
                 availableForCashCarry: a.availableForCashCarry,
+                inRange: a.buyingOption?.cashCarry?.range?.inRange ?? null,
                 quantity: a.buyingOption?.cashCarry?.availability?.quantity ?? null,
                 messageType: a.buyingOption?.cashCarry?.availability?.probability?.thisDay?.messageType ?? null,
                 eligibleForStockNotification: a.buyingOption?.cashCarry?.eligibleForStockNotification ?? null,
@@ -64,6 +67,7 @@ export function projectMultiItemStock(result, itemNos) {
         return {
             itemNo,
             availableForCashCarry: false,
+            inRange: null,
             quantity: null,
             messageType: null,
             eligibleForStockNotification: null,

package/dist/tools/check_cart_availability.js

@@ -3,7 +3,7 @@ import { getMultiItemStock } from "../services/ikea.js";
 import { storeLabel } from "../data/stores.js";
 export const checkCartAvailabilityTool = {
     name: "check_cart_availability",
-    description: "Check whether all items in a shopping list are available in sufficient quantity at a single IKEA store.",
+    description: "Check whether all items in a shopping list are available in sufficient quantity at a single IKEA store. inRange: false on an item means the item is not sold at that store or in that country's market; null means the upstream response carried no range information.",
     inputSchema: {
         type: "object",
         properties: {
@@ -48,6 +48,7 @@ export const checkCartAvailabilityTool = {
                     itemNo: item.itemNo,
                     quantity: item.quantity,
                     inStock: null,
+                    inRange: null,
                     sufficient: false,
                     eligibleForStockNotification: null,
                     errors: [{ code: storeError.code, message: storeError.message, meaning: "store ID does not exist" }],
@@ -55,13 +56,14 @@ export const checkCartAvailabilityTool = {
             }
             const a = byItemNo.get(item.itemNo);
             if (a) {
-                const inStock = a.buyingOption.cashCarry.availability.quantity;
+                const inStock = a.buyingOption?.cashCarry?.availability?.quantity ?? null;
                 return {
                     itemNo: item.itemNo,
                     quantity: item.quantity,
                     inStock,
-                    sufficient: inStock >= item.quantity,
-                    eligibleForStockNotification: a.buyingOption.cashCarry.eligibleForStockNotification ?? null,
+                    inRange: a.buyingOption?.cashCarry?.range?.inRange ?? null,
+                    sufficient: inStock !== null && inStock >= item.quantity,
+                    eligibleForStockNotification: a.buyingOption?.cashCarry?.eligibleForStockNotification ?? null,
                     errors: [],
                 };
             }
@@ -70,6 +72,7 @@ export const checkCartAvailabilityTool = {
                 itemNo: item.itemNo,
                 quantity: item.quantity,
                 inStock: null,
+                inRange: null,
                 sufficient: false,
                 eligibleForStockNotification: null,
                 errors: err