Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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').
This tool takes no arguments.
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').
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| parent_id | integer | Filter to direct children of this category ID. Omit for all categories. Use 0 for root categories only. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"parent_id": {
"type": "integer",
"minimum": 0,
"description": "Filter to direct children of this category ID. Omit for all categories. Use 0 for root categories only."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| id* | integer | Numeric listing ID — visible in the URL and in search_classifieds results |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Numeric listing ID — visible in the URL and in search_classifieds results",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| 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 |
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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Natural-language search request, e.g. 'appartement 3 pièces à Sion' or 'Tesla Model 3 moins de 25000 CHF'. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Natural-language search request, e.g. 'appartement 3 pièces à Sion' or 'Tesla Model 3 moins de 25000 CHF'."
}
},
"additionalProperties": false
}| 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) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Full-text search query (searches title and description)"
},
"sort": {
"enum": [
"recent",
"price_asc",
"price_desc",
"views"
],
"type": "string",
"description": "Sort order: recent (newest first, default), price_asc, price_desc, views"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Results per page (1–50, default 20)"
},
"canton": {
"enum": [
"Geneve",
"Vaud",
"Valais",
"Fribourg",
"Neuchatel",
"Jura",
"Bern",
"Argovie",
"Zurich",
"Lucerne",
"Bale-Ville",
"Etranger"
],
"type": "string",
"description": "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": {
"type": "integer",
"description": "Category ID filter — includes subcategories automatically. Use get_categories to browse available categories.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Pagination offset. Use next_offset from previous response to get next page."
},
"location": {
"type": "string",
"description": "City name or postal code (NPA) — partial match"
},
"price_max": {
"type": "number",
"minimum": 0,
"description": "Maximum price in CHF (inclusive)"
},
"price_min": {
"type": "number",
"minimum": 0,
"description": "Minimum price in CHF (inclusive)"
}
},
"additionalProperties": false
}