Joomil — Swiss Classifieds MCP

valmo-sarl/joomil-mcp

Hooks into Joomil.ch, the leading classifieds marketplace in French-speaking Switzerland, with 45,000+ active listings across 34 categories. Exposes three tools: search_classifieds with filters for keywords, category, canton, location, and price range; get_classified for full listing details including images and vendor info; and get_categories to navigate the category hierarchy. Useful when you need to search Swiss real estate, vehicles, jobs, or secondhand goods in Romandie without leaving your AI workflow. Runs as a remote server on Cloudflare Workers, no local setup required. All data comes from Joomil's public REST API in real time.

tools: 5
transport: HTTP
last updated: Apr 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://joomil-mcp.snowy-surf-deec.workers.dev/mcp --name joomil

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http joomil https://joomil-mcp.snowy-surf-deec.workers.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 5 tools

Verified live against the running server on Nov 6, 2026.

suggest_filtersInfer 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.1 params

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* required

query*string

Natural-language search request, e.g. 'appartement 3 pièces à Sion' or 'Tesla Model 3 moins de 25000 CHF'.

search_classifiedsSearch 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...9 params

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

Parameters* required

cantonstring

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...one of Geneve · Vaud · Valais · Fribourg · Neuchatel · Jura

cat_idinteger

Category ID filter — includes subcategories automatically. Use get_categories to browse available categories.

limitinteger

Results per page (1–50, default 20)

locationstring

City name or postal code (NPA) — partial match

offsetinteger

Pagination offset. Use next_offset from previous response to get next page.

price_maxnumber

Maximum price in CHF (inclusive)

price_minnumber

Minimum price in CHF (inclusive)

qstring

Full-text search query (searches title and description)

sortstring

Sort order: recent (newest first, default), price_asc, price_desc, viewsone of recent · price_asc · price_desc · views

get_classifiedGet 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 relev...1 params

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

Parameters* required

id*integer

Numeric listing ID — visible in the URL and in search_classifieds results

get_categoriesList 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.1 params

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* required

parent_idinteger

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

get_cantonsList 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 'G...

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

No parameters. Call it with no arguments.

Readme

joomil-mcp

MCP server for Joomil.ch — Switzerland's leading French-speaking classifieds marketplace, active since 2007.

Browse and search 45,000+ active listings across 34 categories: real estate, vehicles, jobs, animals, electronics, fashion and more — all from Switzerland's French-speaking regions (Romandie).

Tools

Tool	Description
`suggest_filters`	Infer `search_classifieds` filters from a natural-language query
`search_classifieds`	Search listings with filters: keyword, category, canton (strict enum), location, price range, sort, pagination
`get_classified`	Get full details of a listing by ID: description, images, vendor, expiry date
`get_categories`	List active categories with hierarchy via `parent_id`
`get_cantons`	List the canton values supported by the `canton` filter (API-specific spellings)

Quick Start

This is a remote MCP server — no local installation required.

Endpoint: https://joomil-mcp.snowy-surf-deec.workers.dev/mcp

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

View the full README on GitHub

Details

Repository: github.com/valmo-sarl/joomil-mcp
Category: Search & Web Crawling
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Search & Web Crawling MCP servers

View all

Gas Library Hubwywy-llc/app-script-hubSearch and discover Google Apps Script libraries with AI-generated summaries0stars

Kalshiyakub268/kalshi-mcpSearch, analyze, and trade Kalshi prediction markets through Claude Desktop0stars

Git Summaryyifanyifan897645/git-summary-mcpGit repo intelligence: summaries, blame, changelogs, branch health, and history search0stars

Jobs Baseio.jobsbase/jobsSearch builder roles - jobs where one person owns engineering, product, and QA end-to-end.0stars

Maindex Expert Memory Servicemaindexapp/maindexTeam-shared memory MCP: 15 tools, search, links, collections, bulk ops, Teams workspaces.0stars

Jsoncanvasmcpcentral-io/jsoncanvas-mcpCreate, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.0stars