About Joomil — Swiss Classifieds MCP
Joomil — Swiss Classifieds MCP is an MCP server published by Valmo-Sarl in the Search category: search Swiss classifieds on Joomil.ch — top marketplace in French-speaking Switzerland since 2007.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/Valmo-Sarl/joomil-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
get_cantonsList the canton values supported by the `canton` filter (API-specific spellings)
Parameters not published.
get_categoriesList active categories with hierarchy via `parent_id`
Parameters not published.
get_classifiedGet full details of a listing by ID: description, images, vendor, expiry date
Parameters not published.
search_classifiedsSearch listings with filters: keyword, category, canton (strict enum), location, price range, sort, pagination
Parameters not published.
suggest_filtersInfer `search_classifieds` filters from a natural-language query
Parameters not published.
Ask AI
Ask AI about Joomil — Swiss Classifieds MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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 |
|---|---|
search_classifieds |
Search listings with filters: keyword, category, canton, 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 |
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
- "Find used road bikes under 500 CHF in Geneva on Joomil"
- "Show me apartments for rent in Vaud canton"
- "What electronics categories does Joomil have?"
- "Find a vintage sofa in the Valais region"
- "Search for job offers in hospitality in Neuchatel"
API Reference
search_classifieds
| Parameter | Type | Description |
|---|---|---|
q |
string | Full-text search (title + description) |
cat_id |
number | Category ID — includes subcategories |
canton |
string | Swiss canton: Geneve, Vaud, Valais, Fribourg, Neuchatel, Berne, Jura... |
location |
string | City name or postal code (partial match) |
price_min |
number | Minimum price in CHF |
price_max |
number | Maximum price in CHF |
sort |
string | recent (default), price_asc, price_desc, views |
limit |
number | Results per page (1–50, default 20) |
offset |
number | Pagination offset — use next_offset from previous response |
get_classified
| Parameter | Type | Description |
|---|---|---|
id |
number | Listing ID (from search results or listing URL) |
get_categories
| Parameter | Type | Description |
|---|---|---|
parent_id |
number | Optional — omit for all, 0 for root categories, or any category ID for its children |
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
Deploy Your Own
git clone https://github.com/Valmo-Sarl/joomil-mcp
cd joomil-mcp
npm install
npx wrangler login
npm run deploy
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.