Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
3 tools
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
qstringFull-text search query (searches title and description)
sortstringSort order: recent (newest first, default), price_asc, price_desc, viewsone of
recent · price_asc · price_desc · viewslimitintegerResults per page (1–50, default 20)
cantonstringSwiss canton filter. Examples: Geneve, Vaud, Valais, Fribourg, Neuchatel, Berne, Jura
cat_idintegerCategory ID filter — includes subcategories automatically. Use get_categories to browse available categories.
offsetintegerPagination offset. Use next_offset from previous response to get next page.
locationstringCity name or postal code (NPA) — partial match
price_maxnumberMaximum price in CHF (inclusive)
price_minnumberMinimum price in CHF (inclusive)
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
idintegerNumeric 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_idintegerFilter to direct children of this category ID. Omit for all categories. Use 0 for root categories only.
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
