Tutti

Search tutti.ch Swiss classifieds from your AI agent or the command line — anonymous and read-only by design.

npm version npm downloads license MCP

A Model Context Protocol server that gives any MCP-capable agent (Claude, Codex, Cursor, …) the ability to search listings on tutti.ch, fetch listing details, browse categories, and resolve Swiss localities. The same search core also ships as a tutti CLI with JSON output — handy for scripts and shell-based agents.

Ask your agent things like:

• "Search tutti for a bike under 300 CHF in Zürich."
• "Find free sofas within 10 km of Bern."
• "Get details for tutti listing 81828298."
• "Which tutti categories are there for furniture?"

Why read-only? No login, no messaging, no favorites, no posting, no bulk export. Nothing this server does can touch your account or spam sellers — an agent can browse freely with zero risk. See Safety model.

Quick start

npx -y tutti-mcp

The server speaks MCP over stdio, so you normally don't run it by hand — you point your MCP client at it and let the client spawn it. Pick your client below. Requires Node.js 20+.

claude mcp add tutti -- npx -y tutti-mcp

{
  "mcpServers": {
    "tutti": {
      "command": "npx",
      "args": ["-y", "tutti-mcp"]
    }
  }
}

codex mcp add tutti -- npx -y tutti-mcp

{
  "mcpServers": {
    "tutti": {
      "command": "npx",
      "args": ["-y", "tutti-mcp"]
    }
  }
}

No credentials, no configuration — the server works anonymously out of the box.

Tools

All listing URLs use https://www.tutti.ch/de/vi/<listingID>. Prices are returned as tutti.ch formats them, in CHF — for example "40.-".

search_listings returns nextCursor when another page is available — pass that value back as cursor to get the next page.

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. 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.

CLI

The package also installs a tutti bin with subcommands mirroring the MCP tools:

# One-off with npx
npx -y -p tutti-mcp tutti search velo --max 300 --limit 5

# Or install globally
npm install -g tutti-mcp
tutti search velo --location "Zürich" --radius 10 --max 300
tutti get 81828298
tutti categories
tutti localities "zür"

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>

All commands print JSON to stdout — pretty-printed on a TTY, compact otherwise, so output pipes cleanly into jq. Errors go to stderr with exit code 1.

tutti search sofa --free --location Bern --radius 10 | jq '.listings[].title'

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 upstream 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.

Troubleshooting

Develop from source

git clone https://github.com/domwoe/tutti-mcp.git
cd tutti-mcp
npm install
npm run build

Point a client at the built entrypoint:

claude mcp add tutti -- node /absolute/path/to/tutti-mcp/dist/mcp.js

Verification

npm run typecheck
npm test
npm run build

Live smoke tests against the real upstream API are skipped by default:

TUTTI_LIVE=1 npm test

Manual MCP checks with the inspector:

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:

node dist/cli.js search velo --max 300 --limit 5

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 deliberately provides no 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