tutti-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,251 @@
+# tutti-mcp
+
+> Search tutti.ch Swiss classifieds from an AI agent or a JSON CLI — anonymous and read-only.
+
+[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io)
+[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
+
+`tutti-mcp` exposes the same compact tutti.ch search core through two entry points:
+
+- `tutti-mcp`: MCP stdio server for Claude, Codex, Cursor, and other MCP-capable clients
+- `tutti`: CLI with matching subcommands and JSON output
+
+Ask your agent things like:
+
+- "Search tutti for a bike under 300 CHF in Zürich."
+- "Find free sofas near Bern."
+- "Get details for tutti listing 81828298."
+- "Show me the available tutti categories."
+
+The package is intentionally anonymous read-only: no login, messaging, favorites, posting, caching, or bulk export.
+
+---
+
+## Quick Start
+
+After publishing to npm, run the MCP server directly with `npx`:
+
+```sh
+npx -y tutti-mcp
+```
+
+Use the CLI through the `tutti` bin:
+
+```sh
+npx -y -p tutti-mcp tutti search velo --max 300 --limit 5
+```
+
+Run from a local checkout:
+
+```sh
+npm install
+npm run build
+node dist/cli.js search velo --max 300 --limit 5
+```
+
+The MCP server speaks stdio, so you normally let your client spawn it.
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```sh
+claude mcp add tutti -- npx -y tutti-mcp
+```
+
+Restart Claude Code or start a new session after adding the server, then check `/mcp`.
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add this to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "tutti": {
+      "command": "npx",
+      "args": ["-y", "tutti-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after editing the file.
+</details>
+
+<details>
+<summary><strong>Codex</strong></summary>
+
+```sh
+codex mcp add tutti -- npx -y tutti-mcp
+```
+
+Start a new Codex session after adding the server; MCP tools are injected when the session starts.
+</details>
+
+<details>
+<summary><strong>Cursor / other JSON-config clients</strong></summary>
+
+Most clients accept a config of this shape:
+
+```json
+{
+  "mcpServers": {
+    "tutti": {
+      "command": "npx",
+      "args": ["-y", "tutti-mcp"]
+    }
+  }
+}
+```
+</details>
+
+Requires Node.js 20 or newer.
+
+---
+
+## Tools
+
+All listing URLs use `https://www.tutti.ch/de/vi/<listingID>`. Prices are returned as tutti.ch formats in CHF, for example `"40.-"`.
+
+| Tool | Purpose | Auth required | Writes? |
+| --- | --- | :---: | :---: |
+| `search_listings` | Search listings by query, category, price, locality, radius, sort, and cursor. | No | No |
+| `get_listing` | Fetch compact detail for one listing id, including description, seller, and up to five image URLs. | No | No |
+| `get_categories` | Return `{ id, label, children }` category nodes; ids are usable as `categoryId`. | No | No |
+| `search_localities` | Search Swiss locality names before using location filters. | No | No |
+
+`search_listings` returns `nextCursor` when another page is available. Pass that value back as `cursor`.
+
+When `location` is provided, the server resolves the text to the top matching Swiss locality. Use `search_localities` first when the place name is ambiguous or misspelled.
+
+---
+
+## Suggested Workflows
+
+**Find listings near a place**
+
+1. `search_localities` for the place name if ambiguity matters.
+2. `search_listings` with `location`, optional `radiusKm`, and price filters.
+3. Follow `nextCursor` with another `search_listings` call for page 2.
+4. Use `get_listing` for the items that need full details.
+
+**Browse by category**
+
+1. `get_categories`.
+2. Pick a category `id`.
+3. `search_listings` with `categoryId`.
+
+**Use from the CLI**
+
+```sh
+node dist/cli.js search velo --max 300 --limit 5
+node dist/cli.js search velo --location "Zürich" --radius 10 --max 300
+node dist/cli.js get 81828298
+node dist/cli.js categories
+node dist/cli.js localities "zür"
+```
+
+Installed package bins:
+
+```sh
+npx -y -p tutti-mcp tutti search velo --max 300 --limit 5
+npx -y -p tutti-mcp tutti get 81828298
+
+tutti search velo --max 300 --limit 5
+tutti get 81828298
+tutti categories
+tutti localities "zür"
+```
+
+All CLI commands print JSON to stdout. Output is pretty-printed on a TTY and compact otherwise. Errors are written to stderr and return exit code 1.
+
+---
+
+## Safety Model
+
+This server performs anonymous read-only operations only.
+
+- No credentials are accepted or needed.
+- No listings are posted, edited, favorited, or messaged.
+- No HTTP server is exposed; MCP uses stdio only.
+- No raw `tutti-api` objects are returned to agents. Responses are mapped to compact project-owned payloads.
+- Upstream requests are throttled to avoid rapid repeated traffic and retried only for transient failures.
+
+---
+
+## Develop From Source
+
+```sh
+cd tutti-mcp
+npm install
+npm run build
+```
+
+Point a client at the built entrypoint:
+
+```sh
+claude mcp add tutti -- node /absolute/path/to/tutti-mcp/dist/mcp.js
+```
+
+Before publishing:
+
+```sh
+npm pack --dry-run
+npm publish
+```
+
+### Verification
+
+```sh
+npm run typecheck
+npm test
+npm run build
+```
+
+Live smoke tests are skipped by default:
+
+```sh
+TUTTI_LIVE=1 npm test
+```
+
+Manual MCP checks:
+
+```sh
+npx @modelcontextprotocol/inspector --cli --method tools/list node dist/mcp.js
+npx @modelcontextprotocol/inspector --cli node dist/mcp.js --method tools/call --tool-name search_listings --tool-arg query=velo --tool-arg priceMax=300
+```
+
+Manual CLI check:
+
+```sh
+node dist/cli.js search velo --max 300 --limit 5
+```
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+| --- | --- |
+| MCP client does not show the tools | Restart the client or start a new session so it respawns the server. |
+| `location` matches the wrong place | Run `search_localities` first, then use a more specific place name. |
+| Search fails with a rate-limit message | Wait a few minutes before retrying; the upstream API is behind Cloudflare. |
+| CLI output is one line | Expected when stdout is not a TTY; pipe it through `jq` if needed. |
+| Live tests are skipped | Set `TUTTI_LIVE=1` explicitly. |
+| Inspector command opens a UI instead of running once | Add `--cli` and an explicit `--method`, as shown above. |
+
+---
+
+## Legal Caveat
+
+This package uses a reverse-engineered private API via the `tutti-api` npm package. tutti.ch has no official public API, and its Nutzungsbedingungen prohibit automated queries and reproduction of listings. This project is intended for personal and prototype use only. It does not provide bulk-export or scraping features. Use it responsibly and respect tutti.ch's terms and rate limits.
+
+## Disclaimer
+
+This is an unofficial community project and is not affiliated with tutti.ch or SMG Swiss Marketplace Group.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import { T as TuttiAdapter } from './types-CqLkHDpv.js';
+
+interface CliIO {
+    stdout: {
+        write(chunk: string): void;
+        isTTY?: boolean;
+    };
+    stderr: {
+        write(chunk: string): void;
+    };
+}
+declare function runCli(argv?: string[], adapter?: TuttiAdapter, io?: CliIO, version?: string): Promise<number>;
+
+export { runCli };

package/dist/cli.js

@@ -0,0 +1,406 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFileSync } from "fs";
+import { parseArgs } from "util";
+
+// src/core/client.ts
+import { TuttiClient } from "tutti-api";
+
+// src/core/mapping.ts
+var LISTING_URL_BASE = "https://www.tutti.ch/de/vi";
+function buildListingUrl(id) {
+  return `${LISTING_URL_BASE}/${encodeURIComponent(id)}`;
+}
+function formatLocation(listing) {
+  const info = listing.postcodeInformation;
+  const place = [info?.postcode, info?.locationName].filter(Boolean).join(" ").trim();
+  const canton = info?.canton?.shortName;
+  if (place && canton) {
+    return `${place} (${canton})`;
+  }
+  return place || listing.address || null;
+}
+function mapListingSummary(listing) {
+  return {
+    id: listing.listingID,
+    title: listing.title,
+    price: listing.formattedPrice ?? null,
+    location: formatLocation(listing),
+    category: listing.primaryCategory?.label ?? null,
+    timestamp: listing.timestamp ?? null,
+    url: buildListingUrl(listing.listingID)
+  };
+}
+function mapListingDetail(listing) {
+  return {
+    ...mapListingSummary(listing),
+    description: stringField(listing.body),
+    seller: listing.sellerInfo?.publicAccountID ? {
+      id: listing.sellerInfo.publicAccountID,
+      alias: listing.sellerInfo.alias ?? null
+    } : null,
+    images: imageUrls(listing),
+    address: listing.address ?? null,
+    source: listing.formattedSource ?? null,
+    language: stringField(listing.language)
+  };
+}
+function mapLocality(locality) {
+  return {
+    id: locality.localityID,
+    name: locality.name,
+    type: locality.localityType ?? null
+  };
+}
+function mapCategoryTree(raw) {
+  const candidates = collectCategoryArrays(raw);
+  const best = candidates.sort((a, b) => b.length - a.length)[0] ?? [];
+  return best.map(mapCategoryNode).filter((node) => node !== null);
+}
+function mapCategoryNode(raw) {
+  if (!isRecord(raw)) {
+    return null;
+  }
+  const id = stringField(raw.categoryID ?? raw.id);
+  const label = stringField(raw.label ?? raw.name);
+  if (!id || !label) {
+    return null;
+  }
+  const children = arrayField(raw.children ?? raw.subcategories ?? raw.childCategories).map(mapCategoryNode).filter((node) => node !== null);
+  return { id, label, children };
+}
+function collectCategoryArrays(raw) {
+  const arrays = [];
+  function walk(value) {
+    if (Array.isArray(value)) {
+      if (value.some(looksLikeCategory)) {
+        arrays.push(value);
+      }
+      for (const item of value) {
+        walk(item);
+      }
+      return;
+    }
+    if (isRecord(value)) {
+      for (const child of Object.values(value)) {
+        walk(child);
+      }
+    }
+  }
+  walk(raw);
+  return arrays;
+}
+function looksLikeCategory(value) {
+  return isRecord(value) && typeof (value.categoryID ?? value.id) === "string" && typeof (value.label ?? value.name) === "string";
+}
+function imageUrls(listing) {
+  const images = arrayField(listing.images).map((image) => isRecord(image) && isRecord(image.rendition) ? stringField(image.rendition.src) : null).filter((src) => src !== null);
+  if (images.length > 0) {
+    return images.slice(0, 5);
+  }
+  const thumbnail = listing.thumbnail?.rendition?.src;
+  return thumbnail ? [thumbnail] : [];
+}
+function arrayField(value) {
+  return Array.isArray(value) ? value : [];
+}
+function stringField(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
+// src/core/throttle.ts
+var DEFAULT_MIN_DELAY_MS = 700;
+var DEFAULT_RETRY_DELAYS_MS = [1e3, 3e3];
+var runWithThrottleAndRetry = createThrottledRetry();
+function createThrottledRetry(options = {}) {
+  const minDelayMs = options.minDelayMs ?? DEFAULT_MIN_DELAY_MS;
+  const retryDelaysMs = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;
+  const now = options.now ?? Date.now;
+  const sleep = options.sleep ?? defaultSleep;
+  let previous = Promise.resolve();
+  let lastStartedAt = null;
+  return async function throttledRetry(operation) {
+    const runAfterPrevious = previous.catch(() => void 0);
+    let release = () => void 0;
+    previous = runAfterPrevious.then(() => new Promise((resolve) => {
+      release = resolve;
+    }));
+    await runAfterPrevious;
+    try {
+      for (let attempt = 0; ; attempt += 1) {
+        if (lastStartedAt !== null) {
+          const waitMs = minDelayMs - (now() - lastStartedAt);
+          if (waitMs > 0) {
+            await sleep(waitMs);
+          }
+        }
+        lastStartedAt = now();
+        try {
+          return await operation();
+        } catch (error) {
+          if (!shouldRetry(error) || attempt >= retryDelaysMs.length) {
+            throw normalizeError(error);
+          }
+          await sleep(retryDelaysMs[attempt]);
+        }
+      }
+    } finally {
+      release();
+    }
+  };
+}
+function shouldRetry(error) {
+  const status = statusFromError(error);
+  if (status === void 0) {
+    return isNetworkError(error);
+  }
+  if (isCloudflareBlock(error)) {
+    return false;
+  }
+  return status === 429 || status >= 500;
+}
+function normalizeError(error) {
+  if (isCloudflareBlock(error)) {
+    return new Error("tutti.ch is rate-limiting this client; wait a few minutes");
+  }
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(String(error));
+}
+function statusFromError(error) {
+  return isRecord2(error) && typeof error.status === "number" ? error.status : void 0;
+}
+function isNetworkError(error) {
+  return error instanceof Error && (error.name === "TuttiNetworkError" || error.name === "TypeError");
+}
+function isCloudflareBlock(error) {
+  if (!isRecord2(error) || error.status !== 403 || typeof error.body !== "string") {
+    return false;
+  }
+  return /<html|<!doctype html/i.test(error.body);
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function defaultSleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+
+// src/core/client.ts
+var singleton = null;
+function getClient() {
+  singleton ??= new TuttiClient();
+  return singleton;
+}
+function createTuttiAdapter(client = getClient(), run = runWithThrottleAndRetry) {
+  return {
+    async search(params) {
+      const limit = normalizeLimit(params.limit);
+      let resolvedLocation;
+      let builder = client.search(params.query);
+      if (params.categoryId) {
+        builder = builder.category(params.categoryId);
+      }
+      if (params.freeOnly) {
+        builder = builder.freeOnly();
+      } else if (params.priceMin !== void 0 || params.priceMax !== void 0) {
+        builder = builder.price({ min: params.priceMin, max: params.priceMax });
+      }
+      if (params.location) {
+        const matches = await run(() => client.localities.search(params.location ?? ""));
+        resolvedLocation = matches[0];
+        if (!resolvedLocation) {
+          throw new Error(`No locality matched "${params.location}" - try search_localities`);
+        }
+        builder = builder.location(resolvedLocation);
+        if (params.radiusKm !== void 0) {
+          builder = builder.radius(params.radiusKm);
+        }
+      }
+      if (params.sort) {
+        builder = builder.sort(params.sort, params.direction ?? "desc");
+      } else if (params.direction) {
+        builder = builder.sort("timestamp", params.direction);
+      }
+      if (params.cursor) {
+        builder = builder.cursor(params.cursor);
+      }
+      const page = await run(() => builder.fetch());
+      return {
+        totalCount: page.totalCount,
+        resolvedLocation: resolvedLocation?.name,
+        listings: page.listings.slice(0, limit).map(mapListingSummary),
+        nextCursor: page.pageInfo.hasNextPage ? page.pageInfo.endCursor : null
+      };
+    },
+    async getListing(id) {
+      return mapListingDetail(await run(() => client.listings.get(id)));
+    },
+    async getCategories() {
+      return mapCategoryTree(await run(() => client.categories.tree()));
+    },
+    async searchLocalities(text) {
+      return (await run(() => client.localities.search(text))).map(mapLocality);
+    }
+  };
+}
+function normalizeLimit(limit) {
+  if (limit === void 0) {
+    return 15;
+  }
+  if (!Number.isInteger(limit) || limit < 1 || limit > 30) {
+    throw new Error("limit must be an integer between 1 and 30");
+  }
+  return limit;
+}
+
+// src/cli.ts
+var HELP = `Usage:
+  tutti search <query> [--category id] [--min n] [--max n] [--free] [--location name] [--radius km] [--sort timestamp] [--asc] [--cursor c] [--limit n]
+  tutti get <listingId>
+  tutti categories
+  tutti localities <query>
+  tutti --help
+  tutti --version`;
+async function runCli(argv = process.argv.slice(2), adapter = createTuttiAdapter(), io = { stdout: process.stdout, stderr: process.stderr }, version = readVersion()) {
+  try {
+    const command = argv[0];
+    if (!command || command === "--help" || command === "-h") {
+      io.stdout.write(`${HELP}
+`);
+      return 0;
+    }
+    if (command === "--version" || command === "-v") {
+      io.stdout.write(`${version}
+`);
+      return 0;
+    }
+    switch (command) {
+      case "search":
+        printJson(io, await adapter.search(parseSearchArgs(argv.slice(1))));
+        return 0;
+      case "get":
+        printJson(io, await adapter.getListing(requiredPositional(argv, 1, "listingId")));
+        return 0;
+      case "categories":
+        ensureNoExtraPositionals(argv, 1);
+        printJson(io, await adapter.getCategories());
+        return 0;
+      case "localities":
+        printJson(io, await adapter.searchLocalities(requiredPositional(argv, 1, "query")));
+        return 0;
+      default:
+        throw new Error(`Unknown command "${command}"`);
+    }
+  } catch (error) {
+    io.stderr.write(`${oneLineError(error)}
+`);
+    return 1;
+  }
+}
+function parseSearchArgs(argv) {
+  const parsed = parseArgs({
+    args: argv,
+    allowPositionals: true,
+    options: {
+      category: { type: "string" },
+      min: { type: "string" },
+      max: { type: "string" },
+      free: { type: "boolean" },
+      location: { type: "string" },
+      radius: { type: "string" },
+      sort: { type: "string" },
+      asc: { type: "boolean" },
+      cursor: { type: "string" },
+      limit: { type: "string" }
+    }
+  });
+  const query = parsed.positionals[0];
+  if (!query) {
+    throw new Error("Missing required search query");
+  }
+  ensureNoExtraPositionals(parsed.positionals, 1);
+  const sort = optionalEnum(parsed.values.sort, ["timestamp"], "sort");
+  return {
+    query,
+    categoryId: parsed.values.category,
+    priceMin: optionalNumber(parsed.values.min, "min"),
+    priceMax: optionalNumber(parsed.values.max, "max"),
+    freeOnly: parsed.values.free,
+    location: parsed.values.location,
+    radiusKm: optionalNumber(parsed.values.radius, "radius"),
+    sort,
+    direction: parsed.values.asc ? "asc" : void 0,
+    cursor: parsed.values.cursor,
+    limit: optionalInteger(parsed.values.limit, "limit")
+  };
+}
+function printJson(io, value) {
+  io.stdout.write(`${JSON.stringify(value, null, io.stdout.isTTY ? 2 : 0)}
+`);
+}
+function requiredPositional(argv, index, name) {
+  const value = argv[index];
+  if (!value) {
+    throw new Error(`Missing required ${name}`);
+  }
+  ensureNoExtraPositionals(argv, index + 1);
+  return value;
+}
+function ensureNoExtraPositionals(positionals, expectedCount) {
+  if (positionals.length > expectedCount) {
+    throw new Error(`Unexpected argument "${positionals[expectedCount]}"`);
+  }
+}
+function optionalNumber(value, name) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string") {
+    throw new Error(`--${name} requires a number`);
+  }
+  const number = Number(value);
+  if (!Number.isFinite(number)) {
+    throw new Error(`--${name} requires a number`);
+  }
+  return number;
+}
+function optionalInteger(value, name) {
+  const number = optionalNumber(value, name);
+  if (number !== void 0 && !Number.isInteger(number)) {
+    throw new Error(`--${name} requires an integer`);
+  }
+  return number;
+}
+function optionalEnum(value, allowed, name) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "string" || !allowed.includes(value)) {
+    throw new Error(`--${name} must be one of: ${allowed.join(", ")}`);
+  }
+  return value;
+}
+function oneLineError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.split(/\r?\n/, 1)[0] || "Unknown error";
+}
+function readVersion() {
+  const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+  return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const code = await runCli();
+  process.exitCode = code;
+}
+export {
+  runCli
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/core/client.ts","../src/core/mapping.ts","../src/core/throttle.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { parseArgs } from \"node:util\";\nimport { createTuttiAdapter } from \"./core/client.js\";\nimport type { TuttiAdapter, TuttiSearchParams } from \"./core/types.js\";\n\ninterface CliIO {\n  stdout: { write(chunk: string): void; isTTY?: boolean };\n  stderr: { write(chunk: string): void };\n}\n\nconst HELP = `Usage:\n  tutti search <query> [--category id] [--min n] [--max n] [--free] [--location name] [--radius km] [--sort timestamp] [--asc] [--cursor c] [--limit n]\n  tutti get <listingId>\n  tutti categories\n  tutti localities <query>\n  tutti --help\n  tutti --version`;\n\nexport async function runCli(\n  argv = process.argv.slice(2),\n  adapter: TuttiAdapter = createTuttiAdapter(),\n  io: CliIO = { stdout: process.stdout, stderr: process.stderr },\n  version = readVersion()\n): Promise<number> {\n  try {\n    const command = argv[0];\n\n    if (!command || command === \"--help\" || command === \"-h\") {\n      io.stdout.write(`${HELP}\\n`);\n      return 0;\n    }\n\n    if (command === \"--version\" || command === \"-v\") {\n      io.stdout.write(`${version}\\n`);\n      return 0;\n    }\n\n    switch (command) {\n      case \"search\":\n        printJson(io, await adapter.search(parseSearchArgs(argv.slice(1))));\n        return 0;\n      case \"get\":\n        printJson(io, await adapter.getListing(requiredPositional(argv, 1, \"listingId\")));\n        return 0;\n      case \"categories\":\n        ensureNoExtraPositionals(argv, 1);\n        printJson(io, await adapter.getCategories());\n        return 0;\n      case \"localities\":\n        printJson(io, await adapter.searchLocalities(requiredPositional(argv, 1, \"query\")));\n        return 0;\n      default:\n        throw new Error(`Unknown command \"${command}\"`);\n    }\n  } catch (error) {\n    io.stderr.write(`${oneLineError(error)}\\n`);\n    return 1;\n  }\n}\n\nfunction parseSearchArgs(argv: string[]): TuttiSearchParams {\n  const parsed = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      category: { type: \"string\" },\n      min: { type: \"string\" },\n      max: { type: \"string\" },\n      free: { type: \"boolean\" },\n      location: { type: \"string\" },\n      radius: { type: \"string\" },\n      sort: { type: \"string\" },\n      asc: { type: \"boolean\" },\n      cursor: { type: \"string\" },\n      limit: { type: \"string\" }\n    }\n  });\n\n  const query = parsed.positionals[0];\n  if (!query) {\n    throw new Error(\"Missing required search query\");\n  }\n\n  ensureNoExtraPositionals(parsed.positionals, 1);\n\n  const sort = optionalEnum(parsed.values.sort, [\"timestamp\"], \"sort\");\n\n  return {\n    query,\n    categoryId: parsed.values.category,\n    priceMin: optionalNumber(parsed.values.min, \"min\"),\n    priceMax: optionalNumber(parsed.values.max, \"max\"),\n    freeOnly: parsed.values.free,\n    location: parsed.values.location,\n    radiusKm: optionalNumber(parsed.values.radius, \"radius\"),\n    sort,\n    direction: parsed.values.asc ? \"asc\" : undefined,\n    cursor: parsed.values.cursor,\n    limit: optionalInteger(parsed.values.limit, \"limit\")\n  };\n}\n\nfunction printJson(io: CliIO, value: unknown): void {\n  io.stdout.write(`${JSON.stringify(value, null, io.stdout.isTTY ? 2 : 0)}\\n`);\n}\n\nfunction requiredPositional(argv: string[], index: number, name: string): string {\n  const value = argv[index];\n  if (!value) {\n    throw new Error(`Missing required ${name}`);\n  }\n\n  ensureNoExtraPositionals(argv, index + 1);\n  return value;\n}\n\nfunction ensureNoExtraPositionals(positionals: string[], expectedCount: number): void {\n  if (positionals.length > expectedCount) {\n    throw new Error(`Unexpected argument \"${positionals[expectedCount]}\"`);\n  }\n}\n\nfunction optionalNumber(value: string | boolean | undefined, name: string): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  if (typeof value !== \"string\") {\n    throw new Error(`--${name} requires a number`);\n  }\n\n  const number = Number(value);\n  if (!Number.isFinite(number)) {\n    throw new Error(`--${name} requires a number`);\n  }\n\n  return number;\n}\n\nfunction optionalInteger(value: string | boolean | undefined, name: string): number | undefined {\n  const number = optionalNumber(value, name);\n  if (number !== undefined && !Number.isInteger(number)) {\n    throw new Error(`--${name} requires an integer`);\n  }\n\n  return number;\n}\n\nfunction optionalEnum<T extends string>(value: string | boolean | undefined, allowed: readonly T[], name: string): T | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  if (typeof value !== \"string\" || !allowed.includes(value as T)) {\n    throw new Error(`--${name} must be one of: ${allowed.join(\", \")}`);\n  }\n\n  return value as T;\n}\n\nfunction oneLineError(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return message.split(/\\r?\\n/, 1)[0] || \"Unknown error\";\n}\n\nfunction readVersion(): string {\n  const packageJson = JSON.parse(readFileSync(new URL(\"../package.json\", import.meta.url), \"utf8\")) as { version?: unknown };\n  return typeof packageJson.version === \"string\" ? packageJson.version : \"0.0.0\";\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  const code = await runCli();\n  process.exitCode = code;\n}\n","import { TuttiClient, type Locality, type SearchBuilder } from \"tutti-api\";\nimport { mapCategoryTree, mapListingDetail, mapListingSummary, mapLocality } from \"./mapping.js\";\nimport { runWithThrottleAndRetry, type ThrottledRetry } from \"./throttle.js\";\nimport type { CategoryNode, LocalitySummary, SearchResultPage, TuttiAdapter, TuttiSearchParams } from \"./types.js\";\n\nlet singleton: TuttiClient | null = null;\n\nfunction getClient(): TuttiClient {\n  singleton ??= new TuttiClient();\n  return singleton;\n}\n\nexport function createTuttiAdapter(client = getClient(), run: ThrottledRetry = runWithThrottleAndRetry): TuttiAdapter {\n  return {\n    async search(params: TuttiSearchParams): Promise<SearchResultPage> {\n      const limit = normalizeLimit(params.limit);\n      let resolvedLocation: Locality | undefined;\n      let builder = client.search(params.query);\n\n      if (params.categoryId) {\n        builder = builder.category(params.categoryId);\n      }\n\n      if (params.freeOnly) {\n        builder = builder.freeOnly();\n      } else if (params.priceMin !== undefined || params.priceMax !== undefined) {\n        builder = builder.price({ min: params.priceMin, max: params.priceMax });\n      }\n\n      if (params.location) {\n        const matches = await run(() => client.localities.search(params.location ?? \"\"));\n        resolvedLocation = matches[0];\n        if (!resolvedLocation) {\n          throw new Error(`No locality matched \"${params.location}\" - try search_localities`);\n        }\n        builder = builder.location(resolvedLocation);\n\n        if (params.radiusKm !== undefined) {\n          builder = builder.radius(params.radiusKm);\n        }\n      }\n\n      if (params.sort) {\n        builder = builder.sort(params.sort, params.direction ?? \"desc\");\n      } else if (params.direction) {\n        builder = builder.sort(\"timestamp\", params.direction);\n      }\n\n      if (params.cursor) {\n        builder = builder.cursor(params.cursor);\n      }\n\n      const page = await run(() => builder.fetch());\n\n      return {\n        totalCount: page.totalCount,\n        resolvedLocation: resolvedLocation?.name,\n        listings: page.listings.slice(0, limit).map(mapListingSummary),\n        nextCursor: page.pageInfo.hasNextPage ? page.pageInfo.endCursor : null\n      };\n    },\n\n    async getListing(id: string) {\n      return mapListingDetail(await run(() => client.listings.get(id)));\n    },\n\n    async getCategories(): Promise<CategoryNode[]> {\n      return mapCategoryTree(await run(() => client.categories.tree()));\n    },\n\n    async searchLocalities(text: string): Promise<LocalitySummary[]> {\n      return (await run(() => client.localities.search(text))).map(mapLocality);\n    }\n  };\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n  if (limit === undefined) {\n    return 15;\n  }\n\n  if (!Number.isInteger(limit) || limit < 1 || limit > 30) {\n    throw new Error(\"limit must be an integer between 1 and 30\");\n  }\n\n  return limit;\n}\n\nexport type { SearchBuilder };\n","import type { Listing, Locality } from \"tutti-api\";\nimport type { CategoryNode, ListingDetail, ListingSummary, LocalitySummary } from \"./types.js\";\n\nconst LISTING_URL_BASE = \"https://www.tutti.ch/de/vi\";\n\nexport function buildListingUrl(id: string): string {\n  return `${LISTING_URL_BASE}/${encodeURIComponent(id)}`;\n}\n\nexport function formatLocation(listing: Pick<Listing, \"postcodeInformation\" | \"address\">): string | null {\n  const info = listing.postcodeInformation;\n  const place = [info?.postcode, info?.locationName].filter(Boolean).join(\" \").trim();\n  const canton = info?.canton?.shortName;\n\n  if (place && canton) {\n    return `${place} (${canton})`;\n  }\n\n  return place || listing.address || null;\n}\n\nexport function mapListingSummary(listing: Listing): ListingSummary {\n  return {\n    id: listing.listingID,\n    title: listing.title,\n    price: listing.formattedPrice ?? null,\n    location: formatLocation(listing),\n    category: listing.primaryCategory?.label ?? null,\n    timestamp: listing.timestamp ?? null,\n    url: buildListingUrl(listing.listingID)\n  };\n}\n\nexport function mapListingDetail(listing: Listing): ListingDetail {\n  return {\n    ...mapListingSummary(listing),\n    description: stringField(listing.body),\n    seller: listing.sellerInfo?.publicAccountID\n      ? {\n          id: listing.sellerInfo.publicAccountID,\n          alias: listing.sellerInfo.alias ?? null\n        }\n      : null,\n    images: imageUrls(listing),\n    address: listing.address ?? null,\n    source: listing.formattedSource ?? null,\n    language: stringField(listing.language)\n  };\n}\n\nexport function mapLocality(locality: Locality): LocalitySummary {\n  return {\n    id: locality.localityID,\n    name: locality.name,\n    type: locality.localityType ?? null\n  };\n}\n\nexport function mapCategoryTree(raw: unknown): CategoryNode[] {\n  const candidates = collectCategoryArrays(raw);\n  const best = candidates.sort((a, b) => b.length - a.length)[0] ?? [];\n  return best.map(mapCategoryNode).filter((node): node is CategoryNode => node !== null);\n}\n\nfunction mapCategoryNode(raw: unknown): CategoryNode | null {\n  if (!isRecord(raw)) {\n    return null;\n  }\n\n  const id = stringField(raw.categoryID ?? raw.id);\n  const label = stringField(raw.label ?? raw.name);\n  if (!id || !label) {\n    return null;\n  }\n\n  const children = arrayField(raw.children ?? raw.subcategories ?? raw.childCategories)\n    .map(mapCategoryNode)\n    .filter((node): node is CategoryNode => node !== null);\n\n  return { id, label, children };\n}\n\nfunction collectCategoryArrays(raw: unknown): unknown[][] {\n  const arrays: unknown[][] = [];\n\n  function walk(value: unknown): void {\n    if (Array.isArray(value)) {\n      if (value.some(looksLikeCategory)) {\n        arrays.push(value);\n      }\n      for (const item of value) {\n        walk(item);\n      }\n      return;\n    }\n\n    if (isRecord(value)) {\n      for (const child of Object.values(value)) {\n        walk(child);\n      }\n    }\n  }\n\n  walk(raw);\n  return arrays;\n}\n\nfunction looksLikeCategory(value: unknown): boolean {\n  return isRecord(value) && typeof (value.categoryID ?? value.id) === \"string\" && typeof (value.label ?? value.name) === \"string\";\n}\n\nfunction imageUrls(listing: Listing): string[] {\n  const images = arrayField(listing.images)\n    .map((image) => (isRecord(image) && isRecord(image.rendition) ? stringField(image.rendition.src) : null))\n    .filter((src): src is string => src !== null);\n\n  if (images.length > 0) {\n    return images.slice(0, 5);\n  }\n\n  const thumbnail = listing.thumbnail?.rendition?.src;\n  return thumbnail ? [thumbnail] : [];\n}\n\nfunction arrayField(value: unknown): unknown[] {\n  return Array.isArray(value) ? value : [];\n}\n\nfunction stringField(value: unknown): string | null {\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n","export interface ThrottleRetryOptions {\n  minDelayMs?: number;\n  retryDelaysMs?: readonly number[];\n  now?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n}\n\nexport type ThrottledRetry = <T>(operation: () => Promise<T>) => Promise<T>;\n\nconst DEFAULT_MIN_DELAY_MS = 700;\nconst DEFAULT_RETRY_DELAYS_MS = [1000, 3000] as const;\n\nexport const runWithThrottleAndRetry = createThrottledRetry();\n\nexport function createThrottledRetry(options: ThrottleRetryOptions = {}): ThrottledRetry {\n  const minDelayMs = options.minDelayMs ?? DEFAULT_MIN_DELAY_MS;\n  const retryDelaysMs = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;\n  const now = options.now ?? Date.now;\n  const sleep = options.sleep ?? defaultSleep;\n  let previous = Promise.resolve();\n  let lastStartedAt: number | null = null;\n\n  return async function throttledRetry<T>(operation: () => Promise<T>): Promise<T> {\n    const runAfterPrevious = previous.catch(() => undefined);\n    let release: () => void = () => undefined;\n    previous = runAfterPrevious.then(() => new Promise<void>((resolve) => {\n      release = resolve;\n    }));\n\n    await runAfterPrevious;\n\n    try {\n      for (let attempt = 0; ; attempt += 1) {\n        if (lastStartedAt !== null) {\n          const waitMs = minDelayMs - (now() - lastStartedAt);\n          if (waitMs > 0) {\n            await sleep(waitMs);\n          }\n        }\n\n        lastStartedAt = now();\n\n        try {\n          return await operation();\n        } catch (error) {\n          if (!shouldRetry(error) || attempt >= retryDelaysMs.length) {\n            throw normalizeError(error);\n          }\n\n          await sleep(retryDelaysMs[attempt]);\n        }\n      }\n    } finally {\n      release();\n    }\n  };\n}\n\nexport function shouldRetry(error: unknown): boolean {\n  const status = statusFromError(error);\n\n  if (status === undefined) {\n    return isNetworkError(error);\n  }\n\n  if (isCloudflareBlock(error)) {\n    return false;\n  }\n\n  return status === 429 || status >= 500;\n}\n\nexport function normalizeError(error: unknown): Error {\n  if (isCloudflareBlock(error)) {\n    return new Error(\"tutti.ch is rate-limiting this client; wait a few minutes\");\n  }\n\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(String(error));\n}\n\nfunction statusFromError(error: unknown): number | undefined {\n  return isRecord(error) && typeof error.status === \"number\" ? error.status : undefined;\n}\n\nfunction isNetworkError(error: unknown): boolean {\n  return error instanceof Error && (error.name === \"TuttiNetworkError\" || error.name === \"TypeError\");\n}\n\nfunction isCloudflareBlock(error: unknown): boolean {\n  if (!isRecord(error) || error.status !== 403 || typeof error.body !== \"string\") {\n    return false;\n  }\n\n  return /<html|<!doctype html/i.test(error.body);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction defaultSleep(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n"],"mappings":"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","names":["isRecord"]}

package/dist/mcp.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { T as TuttiAdapter } from './types-CqLkHDpv.js';
+
+declare function createMcpServer(adapter?: TuttiAdapter, version?: string): McpServer;
+declare function runMcpServer(adapter?: TuttiAdapter): Promise<void>;
+declare function toolResult<T>(operation: () => Promise<T>): Promise<CallToolResult>;
+
+export { createMcpServer, runMcpServer, toolResult };

package/dist/mcp.js

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+
+// src/mcp.ts
+import { readFileSync } from "fs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/core/client.ts
+import { TuttiClient } from "tutti-api";
+
+// src/core/mapping.ts
+var LISTING_URL_BASE = "https://www.tutti.ch/de/vi";
+function buildListingUrl(id) {
+  return `${LISTING_URL_BASE}/${encodeURIComponent(id)}`;
+}
+function formatLocation(listing) {
+  const info = listing.postcodeInformation;
+  const place = [info?.postcode, info?.locationName].filter(Boolean).join(" ").trim();
+  const canton = info?.canton?.shortName;
+  if (place && canton) {
+    return `${place} (${canton})`;
+  }
+  return place || listing.address || null;
+}
+function mapListingSummary(listing) {
+  return {
+    id: listing.listingID,
+    title: listing.title,
+    price: listing.formattedPrice ?? null,
+    location: formatLocation(listing),
+    category: listing.primaryCategory?.label ?? null,
+    timestamp: listing.timestamp ?? null,
+    url: buildListingUrl(listing.listingID)
+  };
+}
+function mapListingDetail(listing) {
+  return {
+    ...mapListingSummary(listing),
+    description: stringField(listing.body),
+    seller: listing.sellerInfo?.publicAccountID ? {
+      id: listing.sellerInfo.publicAccountID,
+      alias: listing.sellerInfo.alias ?? null
+    } : null,
+    images: imageUrls(listing),
+    address: listing.address ?? null,
+    source: listing.formattedSource ?? null,
+    language: stringField(listing.language)
+  };
+}
+function mapLocality(locality) {
+  return {
+    id: locality.localityID,
+    name: locality.name,
+    type: locality.localityType ?? null
+  };
+}
+function mapCategoryTree(raw) {
+  const candidates = collectCategoryArrays(raw);
+  const best = candidates.sort((a, b) => b.length - a.length)[0] ?? [];
+  return best.map(mapCategoryNode).filter((node) => node !== null);
+}
+function mapCategoryNode(raw) {
+  if (!isRecord(raw)) {
+    return null;
+  }
+  const id = stringField(raw.categoryID ?? raw.id);
+  const label = stringField(raw.label ?? raw.name);
+  if (!id || !label) {
+    return null;
+  }
+  const children = arrayField(raw.children ?? raw.subcategories ?? raw.childCategories).map(mapCategoryNode).filter((node) => node !== null);
+  return { id, label, children };
+}
+function collectCategoryArrays(raw) {
+  const arrays = [];
+  function walk(value) {
+    if (Array.isArray(value)) {
+      if (value.some(looksLikeCategory)) {
+        arrays.push(value);
+      }
+      for (const item of value) {
+        walk(item);
+      }
+      return;
+    }
+    if (isRecord(value)) {
+      for (const child of Object.values(value)) {
+        walk(child);
+      }
+    }
+  }
+  walk(raw);
+  return arrays;
+}
+function looksLikeCategory(value) {
+  return isRecord(value) && typeof (value.categoryID ?? value.id) === "string" && typeof (value.label ?? value.name) === "string";
+}
+function imageUrls(listing) {
+  const images = arrayField(listing.images).map((image) => isRecord(image) && isRecord(image.rendition) ? stringField(image.rendition.src) : null).filter((src) => src !== null);
+  if (images.length > 0) {
+    return images.slice(0, 5);
+  }
+  const thumbnail = listing.thumbnail?.rendition?.src;
+  return thumbnail ? [thumbnail] : [];
+}
+function arrayField(value) {
+  return Array.isArray(value) ? value : [];
+}
+function stringField(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+
+// src/core/throttle.ts
+var DEFAULT_MIN_DELAY_MS = 700;
+var DEFAULT_RETRY_DELAYS_MS = [1e3, 3e3];
+var runWithThrottleAndRetry = createThrottledRetry();
+function createThrottledRetry(options = {}) {
+  const minDelayMs = options.minDelayMs ?? DEFAULT_MIN_DELAY_MS;
+  const retryDelaysMs = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;
+  const now = options.now ?? Date.now;
+  const sleep = options.sleep ?? defaultSleep;
+  let previous = Promise.resolve();
+  let lastStartedAt = null;
+  return async function throttledRetry(operation) {
+    const runAfterPrevious = previous.catch(() => void 0);
+    let release = () => void 0;
+    previous = runAfterPrevious.then(() => new Promise((resolve) => {
+      release = resolve;
+    }));
+    await runAfterPrevious;
+    try {
+      for (let attempt = 0; ; attempt += 1) {
+        if (lastStartedAt !== null) {
+          const waitMs = minDelayMs - (now() - lastStartedAt);
+          if (waitMs > 0) {
+            await sleep(waitMs);
+          }
+        }
+        lastStartedAt = now();
+        try {
+          return await operation();
+        } catch (error) {
+          if (!shouldRetry(error) || attempt >= retryDelaysMs.length) {
+            throw normalizeError(error);
+          }
+          await sleep(retryDelaysMs[attempt]);
+        }
+      }
+    } finally {
+      release();
+    }
+  };
+}
+function shouldRetry(error) {
+  const status = statusFromError(error);
+  if (status === void 0) {
+    return isNetworkError(error);
+  }
+  if (isCloudflareBlock(error)) {
+    return false;
+  }
+  return status === 429 || status >= 500;
+}
+function normalizeError(error) {
+  if (isCloudflareBlock(error)) {
+    return new Error("tutti.ch is rate-limiting this client; wait a few minutes");
+  }
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(String(error));
+}
+function statusFromError(error) {
+  return isRecord2(error) && typeof error.status === "number" ? error.status : void 0;
+}
+function isNetworkError(error) {
+  return error instanceof Error && (error.name === "TuttiNetworkError" || error.name === "TypeError");
+}
+function isCloudflareBlock(error) {
+  if (!isRecord2(error) || error.status !== 403 || typeof error.body !== "string") {
+    return false;
+  }
+  return /<html|<!doctype html/i.test(error.body);
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function defaultSleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+
+// src/core/client.ts
+var singleton = null;
+function getClient() {
+  singleton ??= new TuttiClient();
+  return singleton;
+}
+function createTuttiAdapter(client = getClient(), run = runWithThrottleAndRetry) {
+  return {
+    async search(params) {
+      const limit = normalizeLimit(params.limit);
+      let resolvedLocation;
+      let builder = client.search(params.query);
+      if (params.categoryId) {
+        builder = builder.category(params.categoryId);
+      }
+      if (params.freeOnly) {
+        builder = builder.freeOnly();
+      } else if (params.priceMin !== void 0 || params.priceMax !== void 0) {
+        builder = builder.price({ min: params.priceMin, max: params.priceMax });
+      }
+      if (params.location) {
+        const matches = await run(() => client.localities.search(params.location ?? ""));
+        resolvedLocation = matches[0];
+        if (!resolvedLocation) {
+          throw new Error(`No locality matched "${params.location}" - try search_localities`);
+        }
+        builder = builder.location(resolvedLocation);
+        if (params.radiusKm !== void 0) {
+          builder = builder.radius(params.radiusKm);
+        }
+      }
+      if (params.sort) {
+        builder = builder.sort(params.sort, params.direction ?? "desc");
+      } else if (params.direction) {
+        builder = builder.sort("timestamp", params.direction);
+      }
+      if (params.cursor) {
+        builder = builder.cursor(params.cursor);
+      }
+      const page = await run(() => builder.fetch());
+      return {
+        totalCount: page.totalCount,
+        resolvedLocation: resolvedLocation?.name,
+        listings: page.listings.slice(0, limit).map(mapListingSummary),
+        nextCursor: page.pageInfo.hasNextPage ? page.pageInfo.endCursor : null
+      };
+    },
+    async getListing(id) {
+      return mapListingDetail(await run(() => client.listings.get(id)));
+    },
+    async getCategories() {
+      return mapCategoryTree(await run(() => client.categories.tree()));
+    },
+    async searchLocalities(text) {
+      return (await run(() => client.localities.search(text))).map(mapLocality);
+    }
+  };
+}
+function normalizeLimit(limit) {
+  if (limit === void 0) {
+    return 15;
+  }
+  if (!Number.isInteger(limit) || limit < 1 || limit > 30) {
+    throw new Error("limit must be an integer between 1 and 30");
+  }
+  return limit;
+}
+
+// src/mcp.ts
+var searchInputSchema = {
+  query: z.string().min(1).optional(),
+  categoryId: z.string().min(1).optional(),
+  priceMin: z.number().nonnegative().optional(),
+  priceMax: z.number().nonnegative().optional(),
+  freeOnly: z.boolean().optional(),
+  location: z.string().min(1).optional(),
+  radiusKm: z.number().positive().optional(),
+  sort: z.enum(["timestamp"]).optional(),
+  direction: z.enum(["asc", "desc"]).optional(),
+  cursor: z.string().min(1).optional(),
+  limit: z.number().int().min(1).max(30).optional()
+};
+var listingInputSchema = {
+  id: z.string().min(1)
+};
+var localityInputSchema = {
+  query: z.string().min(1)
+};
+function createMcpServer(adapter = createTuttiAdapter(), version = readPackageVersion()) {
+  const server = new McpServer({ name: "tutti", version });
+  server.registerTool(
+    "search_listings",
+    {
+      title: "Search tutti.ch listings",
+      description: "Search anonymous read-only tutti.ch listings. Prices are CHF. Use nextCursor as the cursor parameter for the next page. The location parameter accepts a Swiss place name and resolves to the top match; use search_localities first when ambiguous. Results include tutti.ch listing URLs.",
+      inputSchema: searchInputSchema
+    },
+    async (params) => toolResult(() => adapter.search(params))
+  );
+  server.registerTool(
+    "get_listing",
+    {
+      title: "Get a tutti.ch listing",
+      description: "Fetch one tutti.ch listing by id. Returns compact listing detail with description, seller, up to five image URLs, and the canonical tutti.ch URL.",
+      inputSchema: listingInputSchema
+    },
+    async ({ id }) => toolResult(() => adapter.getListing(id))
+  );
+  server.registerTool(
+    "get_categories",
+    {
+      title: "Get tutti.ch categories",
+      description: "Return the tutti.ch category tree as compact { id, label, children } nodes. Use ids as categoryId values when searching listings.",
+      inputSchema: {}
+    },
+    async () => toolResult(() => adapter.getCategories())
+  );
+  server.registerTool(
+    "search_localities",
+    {
+      title: "Search Swiss localities",
+      description: "Search Swiss locality names for tutti.ch location filters. Use this to disambiguate place names before search_listings; search_listings resolves location text to the top match.",
+      inputSchema: localityInputSchema
+    },
+    async ({ query }) => toolResult(() => adapter.searchLocalities(query))
+  );
+  return server;
+}
+async function runMcpServer(adapter = createTuttiAdapter()) {
+  const server = createMcpServer(adapter);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+async function toolResult(operation) {
+  try {
+    const payload = await operation();
+    return {
+      structuredContent: toStructuredContent(payload),
+      content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
+    };
+  } catch (error) {
+    return {
+      isError: true,
+      content: [{ type: "text", text: oneLineError(error) }]
+    };
+  }
+}
+function toStructuredContent(value) {
+  if (typeof value === "object" && value !== null) {
+    return value;
+  }
+  return { value };
+}
+function oneLineError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.split(/\r?\n/, 1)[0] || "Unknown tutti.ch error";
+}
+function readPackageVersion() {
+  const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+  return typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runMcpServer().catch((error) => {
+    console.error(oneLineError(error));
+    process.exitCode = 1;
+  });
+}
+export {
+  createMcpServer,
+  runMcpServer,
+  toolResult
+};
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts","../src/core/client.ts","../src/core/mapping.ts","../src/core/throttle.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\nimport { createTuttiAdapter } from \"./core/client.js\";\nimport type { TuttiAdapter } from \"./core/types.js\";\n\nconst searchInputSchema = {\n  query: z.string().min(1).optional(),\n  categoryId: z.string().min(1).optional(),\n  priceMin: z.number().nonnegative().optional(),\n  priceMax: z.number().nonnegative().optional(),\n  freeOnly: z.boolean().optional(),\n  location: z.string().min(1).optional(),\n  radiusKm: z.number().positive().optional(),\n  sort: z.enum([\"timestamp\"]).optional(),\n  direction: z.enum([\"asc\", \"desc\"]).optional(),\n  cursor: z.string().min(1).optional(),\n  limit: z.number().int().min(1).max(30).optional()\n};\n\nconst listingInputSchema = {\n  id: z.string().min(1)\n};\n\nconst localityInputSchema = {\n  query: z.string().min(1)\n};\n\nexport function createMcpServer(adapter: TuttiAdapter = createTuttiAdapter(), version = readPackageVersion()): McpServer {\n  const server = new McpServer({ name: \"tutti\", version });\n\n  server.registerTool(\n    \"search_listings\",\n    {\n      title: \"Search tutti.ch listings\",\n      description:\n        \"Search anonymous read-only tutti.ch listings. Prices are CHF. Use nextCursor as the cursor parameter for the next page. The location parameter accepts a Swiss place name and resolves to the top match; use search_localities first when ambiguous. Results include tutti.ch listing URLs.\",\n      inputSchema: searchInputSchema\n    },\n    async (params) => toolResult(() => adapter.search(params))\n  );\n\n  server.registerTool(\n    \"get_listing\",\n    {\n      title: \"Get a tutti.ch listing\",\n      description:\n        \"Fetch one tutti.ch listing by id. Returns compact listing detail with description, seller, up to five image URLs, and the canonical tutti.ch URL.\",\n      inputSchema: listingInputSchema\n    },\n    async ({ id }) => toolResult(() => adapter.getListing(id))\n  );\n\n  server.registerTool(\n    \"get_categories\",\n    {\n      title: \"Get tutti.ch categories\",\n      description:\n        \"Return the tutti.ch category tree as compact { id, label, children } nodes. Use ids as categoryId values when searching listings.\",\n      inputSchema: {}\n    },\n    async () => toolResult(() => adapter.getCategories())\n  );\n\n  server.registerTool(\n    \"search_localities\",\n    {\n      title: \"Search Swiss localities\",\n      description:\n        \"Search Swiss locality names for tutti.ch location filters. Use this to disambiguate place names before search_listings; search_listings resolves location text to the top match.\",\n      inputSchema: localityInputSchema\n    },\n    async ({ query }) => toolResult(() => adapter.searchLocalities(query))\n  );\n\n  return server;\n}\n\nexport async function runMcpServer(adapter: TuttiAdapter = createTuttiAdapter()): Promise<void> {\n  const server = createMcpServer(adapter);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nexport async function toolResult<T>(operation: () => Promise<T>): Promise<CallToolResult> {\n  try {\n    const payload = await operation();\n    return {\n      structuredContent: toStructuredContent(payload),\n      content: [{ type: \"text\" as const, text: JSON.stringify(payload, null, 2) }]\n    };\n  } catch (error) {\n    return {\n      isError: true,\n      content: [{ type: \"text\" as const, text: oneLineError(error) }]\n    };\n  }\n}\n\nfunction toStructuredContent(value: unknown): Record<string, unknown> {\n  if (typeof value === \"object\" && value !== null) {\n    return value as Record<string, unknown>;\n  }\n\n  return { value };\n}\n\nfunction oneLineError(error: unknown): string {\n  const message = error instanceof Error ? error.message : String(error);\n  return message.split(/\\r?\\n/, 1)[0] || \"Unknown tutti.ch error\";\n}\n\nfunction readPackageVersion(): string {\n  const packageJson = JSON.parse(readFileSync(new URL(\"../package.json\", import.meta.url), \"utf8\")) as { version?: unknown };\n  return typeof packageJson.version === \"string\" ? packageJson.version : \"0.0.0\";\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  runMcpServer().catch((error: unknown) => {\n    console.error(oneLineError(error));\n    process.exitCode = 1;\n  });\n}\n","import { TuttiClient, type Locality, type SearchBuilder } from \"tutti-api\";\nimport { mapCategoryTree, mapListingDetail, mapListingSummary, mapLocality } from \"./mapping.js\";\nimport { runWithThrottleAndRetry, type ThrottledRetry } from \"./throttle.js\";\nimport type { CategoryNode, LocalitySummary, SearchResultPage, TuttiAdapter, TuttiSearchParams } from \"./types.js\";\n\nlet singleton: TuttiClient | null = null;\n\nfunction getClient(): TuttiClient {\n  singleton ??= new TuttiClient();\n  return singleton;\n}\n\nexport function createTuttiAdapter(client = getClient(), run: ThrottledRetry = runWithThrottleAndRetry): TuttiAdapter {\n  return {\n    async search(params: TuttiSearchParams): Promise<SearchResultPage> {\n      const limit = normalizeLimit(params.limit);\n      let resolvedLocation: Locality | undefined;\n      let builder = client.search(params.query);\n\n      if (params.categoryId) {\n        builder = builder.category(params.categoryId);\n      }\n\n      if (params.freeOnly) {\n        builder = builder.freeOnly();\n      } else if (params.priceMin !== undefined || params.priceMax !== undefined) {\n        builder = builder.price({ min: params.priceMin, max: params.priceMax });\n      }\n\n      if (params.location) {\n        const matches = await run(() => client.localities.search(params.location ?? \"\"));\n        resolvedLocation = matches[0];\n        if (!resolvedLocation) {\n          throw new Error(`No locality matched \"${params.location}\" - try search_localities`);\n        }\n        builder = builder.location(resolvedLocation);\n\n        if (params.radiusKm !== undefined) {\n          builder = builder.radius(params.radiusKm);\n        }\n      }\n\n      if (params.sort) {\n        builder = builder.sort(params.sort, params.direction ?? \"desc\");\n      } else if (params.direction) {\n        builder = builder.sort(\"timestamp\", params.direction);\n      }\n\n      if (params.cursor) {\n        builder = builder.cursor(params.cursor);\n      }\n\n      const page = await run(() => builder.fetch());\n\n      return {\n        totalCount: page.totalCount,\n        resolvedLocation: resolvedLocation?.name,\n        listings: page.listings.slice(0, limit).map(mapListingSummary),\n        nextCursor: page.pageInfo.hasNextPage ? page.pageInfo.endCursor : null\n      };\n    },\n\n    async getListing(id: string) {\n      return mapListingDetail(await run(() => client.listings.get(id)));\n    },\n\n    async getCategories(): Promise<CategoryNode[]> {\n      return mapCategoryTree(await run(() => client.categories.tree()));\n    },\n\n    async searchLocalities(text: string): Promise<LocalitySummary[]> {\n      return (await run(() => client.localities.search(text))).map(mapLocality);\n    }\n  };\n}\n\nfunction normalizeLimit(limit: number | undefined): number {\n  if (limit === undefined) {\n    return 15;\n  }\n\n  if (!Number.isInteger(limit) || limit < 1 || limit > 30) {\n    throw new Error(\"limit must be an integer between 1 and 30\");\n  }\n\n  return limit;\n}\n\nexport type { SearchBuilder };\n","import type { Listing, Locality } from \"tutti-api\";\nimport type { CategoryNode, ListingDetail, ListingSummary, LocalitySummary } from \"./types.js\";\n\nconst LISTING_URL_BASE = \"https://www.tutti.ch/de/vi\";\n\nexport function buildListingUrl(id: string): string {\n  return `${LISTING_URL_BASE}/${encodeURIComponent(id)}`;\n}\n\nexport function formatLocation(listing: Pick<Listing, \"postcodeInformation\" | \"address\">): string | null {\n  const info = listing.postcodeInformation;\n  const place = [info?.postcode, info?.locationName].filter(Boolean).join(\" \").trim();\n  const canton = info?.canton?.shortName;\n\n  if (place && canton) {\n    return `${place} (${canton})`;\n  }\n\n  return place || listing.address || null;\n}\n\nexport function mapListingSummary(listing: Listing): ListingSummary {\n  return {\n    id: listing.listingID,\n    title: listing.title,\n    price: listing.formattedPrice ?? null,\n    location: formatLocation(listing),\n    category: listing.primaryCategory?.label ?? null,\n    timestamp: listing.timestamp ?? null,\n    url: buildListingUrl(listing.listingID)\n  };\n}\n\nexport function mapListingDetail(listing: Listing): ListingDetail {\n  return {\n    ...mapListingSummary(listing),\n    description: stringField(listing.body),\n    seller: listing.sellerInfo?.publicAccountID\n      ? {\n          id: listing.sellerInfo.publicAccountID,\n          alias: listing.sellerInfo.alias ?? null\n        }\n      : null,\n    images: imageUrls(listing),\n    address: listing.address ?? null,\n    source: listing.formattedSource ?? null,\n    language: stringField(listing.language)\n  };\n}\n\nexport function mapLocality(locality: Locality): LocalitySummary {\n  return {\n    id: locality.localityID,\n    name: locality.name,\n    type: locality.localityType ?? null\n  };\n}\n\nexport function mapCategoryTree(raw: unknown): CategoryNode[] {\n  const candidates = collectCategoryArrays(raw);\n  const best = candidates.sort((a, b) => b.length - a.length)[0] ?? [];\n  return best.map(mapCategoryNode).filter((node): node is CategoryNode => node !== null);\n}\n\nfunction mapCategoryNode(raw: unknown): CategoryNode | null {\n  if (!isRecord(raw)) {\n    return null;\n  }\n\n  const id = stringField(raw.categoryID ?? raw.id);\n  const label = stringField(raw.label ?? raw.name);\n  if (!id || !label) {\n    return null;\n  }\n\n  const children = arrayField(raw.children ?? raw.subcategories ?? raw.childCategories)\n    .map(mapCategoryNode)\n    .filter((node): node is CategoryNode => node !== null);\n\n  return { id, label, children };\n}\n\nfunction collectCategoryArrays(raw: unknown): unknown[][] {\n  const arrays: unknown[][] = [];\n\n  function walk(value: unknown): void {\n    if (Array.isArray(value)) {\n      if (value.some(looksLikeCategory)) {\n        arrays.push(value);\n      }\n      for (const item of value) {\n        walk(item);\n      }\n      return;\n    }\n\n    if (isRecord(value)) {\n      for (const child of Object.values(value)) {\n        walk(child);\n      }\n    }\n  }\n\n  walk(raw);\n  return arrays;\n}\n\nfunction looksLikeCategory(value: unknown): boolean {\n  return isRecord(value) && typeof (value.categoryID ?? value.id) === \"string\" && typeof (value.label ?? value.name) === \"string\";\n}\n\nfunction imageUrls(listing: Listing): string[] {\n  const images = arrayField(listing.images)\n    .map((image) => (isRecord(image) && isRecord(image.rendition) ? stringField(image.rendition.src) : null))\n    .filter((src): src is string => src !== null);\n\n  if (images.length > 0) {\n    return images.slice(0, 5);\n  }\n\n  const thumbnail = listing.thumbnail?.rendition?.src;\n  return thumbnail ? [thumbnail] : [];\n}\n\nfunction arrayField(value: unknown): unknown[] {\n  return Array.isArray(value) ? value : [];\n}\n\nfunction stringField(value: unknown): string | null {\n  return typeof value === \"string\" && value.length > 0 ? value : null;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n","export interface ThrottleRetryOptions {\n  minDelayMs?: number;\n  retryDelaysMs?: readonly number[];\n  now?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n}\n\nexport type ThrottledRetry = <T>(operation: () => Promise<T>) => Promise<T>;\n\nconst DEFAULT_MIN_DELAY_MS = 700;\nconst DEFAULT_RETRY_DELAYS_MS = [1000, 3000] as const;\n\nexport const runWithThrottleAndRetry = createThrottledRetry();\n\nexport function createThrottledRetry(options: ThrottleRetryOptions = {}): ThrottledRetry {\n  const minDelayMs = options.minDelayMs ?? DEFAULT_MIN_DELAY_MS;\n  const retryDelaysMs = options.retryDelaysMs ?? DEFAULT_RETRY_DELAYS_MS;\n  const now = options.now ?? Date.now;\n  const sleep = options.sleep ?? defaultSleep;\n  let previous = Promise.resolve();\n  let lastStartedAt: number | null = null;\n\n  return async function throttledRetry<T>(operation: () => Promise<T>): Promise<T> {\n    const runAfterPrevious = previous.catch(() => undefined);\n    let release: () => void = () => undefined;\n    previous = runAfterPrevious.then(() => new Promise<void>((resolve) => {\n      release = resolve;\n    }));\n\n    await runAfterPrevious;\n\n    try {\n      for (let attempt = 0; ; attempt += 1) {\n        if (lastStartedAt !== null) {\n          const waitMs = minDelayMs - (now() - lastStartedAt);\n          if (waitMs > 0) {\n            await sleep(waitMs);\n          }\n        }\n\n        lastStartedAt = now();\n\n        try {\n          return await operation();\n        } catch (error) {\n          if (!shouldRetry(error) || attempt >= retryDelaysMs.length) {\n            throw normalizeError(error);\n          }\n\n          await sleep(retryDelaysMs[attempt]);\n        }\n      }\n    } finally {\n      release();\n    }\n  };\n}\n\nexport function shouldRetry(error: unknown): boolean {\n  const status = statusFromError(error);\n\n  if (status === undefined) {\n    return isNetworkError(error);\n  }\n\n  if (isCloudflareBlock(error)) {\n    return false;\n  }\n\n  return status === 429 || status >= 500;\n}\n\nexport function normalizeError(error: unknown): Error {\n  if (isCloudflareBlock(error)) {\n    return new Error(\"tutti.ch is rate-limiting this client; wait a few minutes\");\n  }\n\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(String(error));\n}\n\nfunction statusFromError(error: unknown): number | undefined {\n  return isRecord(error) && typeof error.status === \"number\" ? error.status : undefined;\n}\n\nfunction isNetworkError(error: unknown): boolean {\n  return error instanceof Error && (error.name === \"TuttiNetworkError\" || error.name === \"TypeError\");\n}\n\nfunction isCloudflareBlock(error: unknown): boolean {\n  if (!isRecord(error) || error.status !== 403 || typeof error.body !== \"string\") {\n    return false;\n  }\n\n  return /<html|<!doctype html/i.test(error.body);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction defaultSleep(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n"],"mappings":"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","names":["isRecord"]}

package/dist/types-CqLkHDpv.d.ts

@@ -0,0 +1,57 @@
+interface ListingSummary {
+    id: string;
+    title: string;
+    price: string | null;
+    location: string | null;
+    category: string | null;
+    timestamp: string | null;
+    url: string;
+}
+interface SearchResultPage {
+    totalCount: number;
+    resolvedLocation?: string;
+    listings: ListingSummary[];
+    nextCursor: string | null;
+}
+interface ListingDetail extends ListingSummary {
+    description: string | null;
+    seller: {
+        id: string;
+        alias: string | null;
+    } | null;
+    images: string[];
+    address: string | null;
+    source: string | null;
+    language: string | null;
+}
+interface CategoryNode {
+    id: string;
+    label: string;
+    children: CategoryNode[];
+}
+interface LocalitySummary {
+    id: string;
+    name: string;
+    type: string | null;
+}
+interface TuttiSearchParams {
+    query?: string;
+    categoryId?: string;
+    priceMin?: number;
+    priceMax?: number;
+    freeOnly?: boolean;
+    location?: string;
+    radiusKm?: number;
+    sort?: "timestamp";
+    direction?: "asc" | "desc";
+    cursor?: string;
+    limit?: number;
+}
+interface TuttiAdapter {
+    search(params: TuttiSearchParams): Promise<SearchResultPage>;
+    getListing(id: string): Promise<ListingDetail>;
+    getCategories(): Promise<CategoryNode[]>;
+    searchLocalities(text: string): Promise<LocalitySummary[]>;
+}
+
+export type { TuttiAdapter as T };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "tutti-mcp",
+  "version": "0.1.0",
+  "description": "MCP server and CLI for searching tutti.ch classifieds.",
+  "license": "MIT",
+  "author": "domwoe",
+  "homepage": "https://github.com/domwoe/tutti-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/domwoe/tutti-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/domwoe/tutti-mcp/issues"
+  },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "tutti-mcp": "./dist/mcp.js",
+    "tutti": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "tutti-api": "^2.1.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0"
+  }
+}