Joomil — Swiss Classifieds MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Joomil — Swiss Classifieds MCP": {
      "url": "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• suggest_filters read-only

  Infer search_classifieds filters from a natural-language query. Use this before search_classifieds when the user mentions a category, location, canton or price in free text. Returns a ready-to-use filters object, a category confidence score and warnings for uncertain matches.

  Parameters:

  • query (required) — string — Natural-language search request, e.g. 'appartement 3 pièces à Sion' or 'Tesla Model 3 moins de 25000 CHF'.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• search_classifieds read-only

  Search classified ads on Joomil.ch — Switzerland's leading French-speaking classifieds marketplace (since 2007). Returns a paginated list of public listings with title, description (truncated to 300 chars), price, location, category and vendor info. All parameters are optional — call with no arguments to browse the latest listings. Use get_classified to fetch full details of a specific listing.

  Parameters:

  • q — string — Full-text search query (searches title and description)
  • sort — string — Sort order: recent (newest first, default), price_asc, price_desc, views
  • limit — integer — Results per page (1–50, default 20)
  • canton — string — Swiss canton filter — strict enum. Use get_cantons for the official list. WARNING: values are API-specific (e.g. 'Bern' not 'Berne', 'Geneve' not 'Genève'/'Geneva'). Supported: Geneve, Vaud, Valais, Fribourg, Neuchatel, Jura, Bern, Argovie, Zurich, Lucerne, Bale-Ville, Etranger.
  • cat_id — integer — Category ID filter — includes subcategories automatically. Use get_categories to browse available categories.
  • offset — integer — Pagination offset. Use next_offset from previous response to get next page.
  • location — string — City name or postal code (NPA) — partial match
  • price_max — number — Maximum price in CHF (inclusive)
  • price_min — number — Minimum price in CHF (inclusive)

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_classified read-only

  Get full details of a single classified ad on Joomil.ch by its numeric ID. Returns complete description, all images URLs, category breadcrumb (full_path), vendor info (name, certified status, pro company), expiry date and boost level. Use search_classifieds first to find relevant listing IDs.

  Parameters:

  • id (required) — integer — Numeric listing ID — visible in the URL and in search_classifieds results

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_categories read-only

  List active categories of the Joomil.ch marketplace. Returns a flat list with parent_id for hierarchy reconstruction. Omit parent_id for all categories, use parent_id=0 for root categories only, or pass a specific ID to get direct children of that category.

  Parameters:

  • parent_id — integer — Filter to direct children of this category ID. Omit for all categories. Use 0 for root categories only.

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

• get_cantons read-only

  List the Swiss cantons supported by Joomil's `canton` filter. Returns the exact `name` value to pass to search_classifieds, plus a readable French label. Call this before filtering by canton — the API values are non-obvious (e.g. 'Bern' not 'Berne', 'Geneve' not 'Genève' or 'Geneva').

  Hints: read-only yes · destructive no · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.