io.github.ValmoDevPublished by GitHub account ValmoDevv1.0.0Updated Oct 24, 2026
Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.
Remote MCP server for searching Joomil.ch, a Swiss French-speaking classifieds marketplace, letting an assistant find and read public listings.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.ValmoDev%2Fjoomil/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"joomil-swiss-classifieds": {
"type": "http",
"url": "https://joomil-mcp.snowy-surf-deec.workers.dev/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).
This is a remote MCP server — no local installation required.
Endpoint: https://joomil-mcp.snowy-surf-deec.workers.dev/mcp
Add to ~/.claude/claude_desktop_config.json:
Add to your MCP settings:
Tip for agents: call
get_cantonsbefore filtering by canton — the API uses non-obvious spellings (e.g.BernnotBerne,GenevenotGenève/Geneva). For free-text user requests, callsuggest_filtersfirst, then pass the returnedfiltersobject tosearch_classifieds.
suggest_filtersReturns a ready-to-use filters object for search_classifieds, plus a category confidence score and warnings when matching is uncertain. Category metadata is cached briefly by the MCP layer to avoid refetching the category tree for every suggestion.
Useful examples:
search_classifiedsTool responses include a short human-readable summary followed by compact serialized JSON in content for MCP backward compatibility. Full data is also returned in structuredContent with results, total, limit, offset, has_more, next_offset, and filtered_out (items removed from the current page by MCP-side category restrictions).
Result shape (each item):
get_classifiedReturns full listing details, including complete description, images, category path, expiry date, boost level, and seller details.
get_categoriesget_cantonsNo parameters. Returns the canton values accepted by search_classifieds' canton filter, with their French labels:
Always pass the name field (not label_fr nor code) to the canton filter.
This MCP server is read-only and uses public data only.
url to open Joomil.ch directly.get_cantons are accepted. Other spellings (Berne, Genève, Geneva, GE, VD...) are silently ignored by the upstream API and would return all listings instead of a filtered set — the strict enum here prevents that.price.amount: null (price on request) or 0 (free).isError: true.MIT
Source: README.md at commit 345aa48
Suggest Filters
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.
queryrequiredSearch Classifieds
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.
qsortlimitcantoncat_idoffsetlocationprice_maxprice_minGet Classified
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.
idrequiredGet Categories
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.
parent_idGet Cantons
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').
Takes no parameters.
90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a license in the repository or the registry entry.
{ "mcpServers": { "joomil": { "command": "npx", "args": ["mcp-remote", "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"] } }}{ "joomil": { "url": "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp" }}{ "query": "appartement 3 pièces à Sion", "filters": { "q": "3 pièces", "cat_id": 10255, "canton": null, "location": "Sion", "price_min": null, "price_max": null, "sort": "recent", "limit": 20 }, "category": { "id": 10255, "name": "Appartements", "url": "https://www.joomil.ch/annonces/immobilier/locations/appartements/10255", "parent_id": 339, "confidence": 0.82, "reason": "requête immobilière appartement" }, "confidence": 0.74, "warnings": [], "next_step": "Call search_classifieds with the filters object. Adjust q or cat_id if the result set is too broad."}{ "id": 366872, "title": "Maison avec étangs", "price": { "amount": 237977.5, "currency": "CHF" }, "location": { "city": "Saint Eugène", "postal_code": "71320", "canton": "Geneve", "country": "FR" }, "category": { "id": 10261, "name": "Maisons & Villas", "url": "https://..." }, "url": "https://www.joomil.ch/annonce/.../366872", "created_at": "2026-06-26T22:17:11+02:00", "has_picture": true, "seller": { "name": "jpclair", "certified": false }}{ "cantons": [ { "name": "Geneve", "label_fr": "Genève", "code": "GE", "region": "Romandie" }, { "name": "Bern", "label_fr": "Berne", "code": "BE", "region": "Suisse alémanique" } ], "total": 12}git clone https://github.com/Valmo-Sarl/joomil-mcpcd joomil-mcpnpm installnpx wrangler loginnpm run deploy