Server data from the Official MCP Registry
Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.
About
Search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.
Remote endpoints: streamable-http: https://joomil-mcp.snowy-surf-deec.workers.dev/mcp
Security Report
Valid MCP server (2 strong, 2 medium validity signals). 7 known CVEs in dependencies (0 critical, 4 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
Endpoint verified · Open access · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Found in Source Code
Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.
How to Connect
Remote Plugin
No local installation needed. Your AI client connects to the remote endpoint directly.
Add this to your MCP configuration to connect:
{
"mcpServers": {
"io-github-valmodev-joomil": {
"url": "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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:
{
"mcpServers": {
"joomil": {
"command": "npx",
"args": ["mcp-remote", "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"]
}
}
}
Cursor
Add to your MCP settings:
{
"joomil": {
"url": "https://joomil-mcp.snowy-surf-deec.workers.dev/mcp"
}
}
Example Prompts
- "Trouve-moi une voiture automatique à moins de 10'000 CHF dans le canton de Vaud."
- "Cherche un appartement 3 pièces à Sion."
- "Quelles catégories d'électronique propose Joomil ?"
- "Montre-moi les annonces de canapés vintage en Valais."
- "Cherche des offres d'emploi dans l'hôtellerie à Neuchâtel."
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.
API Reference
suggest_filters
| Parameter | Type | Description |
|---|---|---|
query | string | Natural-language search request, e.g. appartement 3 pièces à Sion |
Returns 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:
| User request | Typical suggested filters |
|---|---|
Tesla Model 3 moins de 25'000 CHF | q: "Tesla Model 3", cat_id: 101, price_max: 25000, sort: "price_asc" |
vélo budget 1.5k CHF | q: null, category in sport/leisure, price_max: 1500, sort: "price_asc" |
appartement 3 pièces à Sion | q: "3 pièces", cat_id: 10255, location: "Sion" |
voiture entre 10'000 et 20'000 CHF | cat_id: 101, price_min: 10000, price_max: 20000 |
Golf GTI dans le canton de Vaud | q: "Golf GTI", cat_id: 101, canton: "Vaud" |
canapé vintage à Lausanne | q: "vintage", cat_id: 10022, location: "Lausanne" |
iPhone 14 à Genève | q: "iPhone 14", cat_id: 10127, location: "Genève" |
{
"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."
}
search_classifieds
| Parameter | Type | Description |
|---|---|---|
q | string | Full-text search (title + description) |
cat_id | number | Category ID — includes subcategories |
canton | enum | Strict enum — see get_cantons. Geneve, Vaud, Valais, Fribourg, Neuchatel, Jura, Bern, Argovie, Zurich, Lucerne, Bale-Ville, Etranger |
location | string | City name or postal code (partial match) |
price_min | number | Minimum price in CHF |
price_max | number | Maximum price in CHF |
sort | enum | recent (default, newest first), price_asc, price_desc, views (most viewed) |
limit | number | Results per page (1–50, default 20) |
offset | number | Pagination offset — use next_offset from previous response |
Tool 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):
{
"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 }
}
get_classified
| Parameter | Type | Description |
|---|---|---|
id | number | Listing ID (from search results or listing URL) |
Returns full listing details, including complete description, images, category path, expiry date, boost level, and seller details.
get_categories
| Parameter | Type | Description |
|---|---|---|
parent_id | number | Optional — omit for all, 0 for root categories, or any category ID for its children |
get_cantons
No parameters. Returns the canton values accepted by search_classifieds' canton filter, with their French labels:
{
"cantons": [
{ "name": "Geneve", "label_fr": "Genève", "code": "GE", "region": "Romandie" },
{ "name": "Bern", "label_fr": "Berne", "code": "BE", "region": "Suisse alémanique" }
],
"total": 12
}
Always pass the name field (not label_fr nor code) to the canton filter.
Data
- Source: Joomil.ch public REST API
- Coverage: 45,000+ active listings, 34 top-level categories, 190,000+ registered users
- Location: Switzerland (French-speaking regions — Romandie)
- Language: French
- Update frequency: Real-time
- Authentication: None required
Limitations
This MCP server is read-only and uses public data only.
- No write operations: cannot create, edit, or delete listings; cannot contact sellers.
- No member login: no user accounts, no messages, no favorites, no saved searches. A private worker-to-origin service credential does not grant access to private data.
- No seller contact: phone numbers and email addresses are not exposed — use the listing
urlto open Joomil.ch directly. - No posting: publishing an ad must be done on joomil.ch.
- Restricted categories: Erotique (28), Rencontres & Amitié (14000), Voyance & Astrologie (651), and their descendants are filtered out by the MCP layer per content policy. The underlying PHP API remains available for direct use.
- Canton filter is strict: only the values returned by
get_cantonsare 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. - Currency: all prices are in CHF. Listings may have
price.amount: null(price on request) or0(free). - Upstream errors: Joomil API failures are returned as MCP tool errors with
isError: true.
Deploy Your Own
v1.3.0 — deployed and verified on 2026-11-19
Production v1.3.0 separates MCP and direct REST quotas. Its five tools were
verified before and after the coordinated PHP origin rollout. Clients still
connect anonymously; the operator must provision
JOOMIL_API_TOKEN as a Worker secret, with the matching SHA-256 and an
explicit service limit at the Joomil origin. A self-hosted copy does not
automatically obtain a privileged origin service budget.
- Active: 60 tool calls/session/minute, plus 600 ingress GET/POST/IP/minute. Tool checks use the initialized SDK Durable Object, including batched calls.
- These native limits are approximate per Cloudflare location, not strict global limits or authenticated-person allowances. Sessions can be recreated; NATs/AI providers may share ingress IPs. A separate atomic origin service cap bounds aggregate upstream traffic.
MCP_SESSION_LIMITER/MCP_IP_LIMITERuse namespaces2026111901/2026111902, checked unused before deployment and now reserved to these uses. Verify account-wide uniqueness before assigning new namespaces.- Missing service secret/bindings fail closed (503), exceeded budgets give429. No User-Agent/IP-header exemption. No origin redirect follows the secret.
.dev.vars.exampleis empty by design. Do not commit a real.dev.vars, put a secret in[vars], paste it in chat, or send it in a URL.- Wrangler >=4.36 required. Run
npm run typecheckandnpm testoffline before any deployment. Tests use fictitious credentials and intercept all origin calls; the protocol test runs the real SDK/DO transport in Miniflare/workerd. - No deployment, registry publication or secret provisioning is performed by tests. Coordinate worker-first rollout with the origin; rolling back blindly to v1.2.1 afterwards would lose the service credential and re-share direct quotas.
Operator's canonical plan in the workspace:
../my.joomil.ch/docs/operations/explicit-schema-preparation-2026-11-19/MCP-QUOTAS.md.
Deployment evidence and safe recovery:
../my.joomil.ch/docs/operations/explicit-schema-preparation-2026-11-19/DEPLOYMENT-STATUS.md.
Cloudflare version 0b412245-e585-4e35-9bc9-761bdbf537e2, 100% traffic;
existing Durable Object/storage preserved. Not published to the MCP registry by
this rollout. Christophe subsequently requested a dedicated commit, tag and push
of this release in both repositories.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
