
Joomil — Swiss Classifieds MCP
- Updated June 26, 2026
- Valmo-Sarl/joomil-mcp
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. Exposes 3 MCP tools including io.github.ValmoDev/joomil, | Tool | Description |, |------|-------------|, | `get_categories` | List active categories with hierarchy via `parent_id` |. Install via Claude Desktop, Cursor, or any MCP-compatible client using the upstream server manifest.
- **Endpoint:** `https://joomil-mcp.snowy-surf-deec.workers.dev/mcp`
- *"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"*
Joomil — Swiss Classifieds MCP by the numbers
- Exposes 3 verified tools (MCP introspection)
- Data as of Jul 9, 2026 (Skillselion catalog sync)
claude mcp add --transport http joomil https://joomil-mcp.snowy-surf-deec.workers.dev/mcpAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| Transport | HTTP |
|---|---|
| Auth | None |
| Tools | 3 |
| Last updated | June 26, 2026 |
| Repository | Valmo-Sarl/joomil-mcp ↗ |
How do I connect Joomil - Swiss Classifieds MCP to my MCP client?
Search Swiss classifieds on Joomil.ch - top marketplace in French-speaking Switzerland since 2007.
Who is it for?
Teams wiring Joomil - Swiss Classifieds MCP into Claude, Cursor, or custom agents for data analytics.
Skip if: Skip when you need a non-MCP SDK or hosted API without stdio/SSE transport.
What you get
Working Joomil - Swiss Classifieds MCP MCP server with verified tool registration and client config.
- Configured remote MCP entry for Joomil search
- Agent-retrieved listing and search results from Joomil.ch
By the numbers
- [object Object]
Joomil — Swiss Classifieds MCP capabilities & compatibility
- Capabilities
- joomil swiss classifieds mcp mcp tool registra · joomil swiss classifieds mcp client configurat · joomil swiss classifieds mcp agent workflow in
- Use cases
- orchestration
- Runs
- Remote server
Tools 3
Public tool metadata - what this server can do for an agent.
search_classifieds9 paramsSearch 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.
qstringFull-text search query (searches title and description)cat_idintegerCategory ID filter — includes subcategories automatically. Use get_categories to browse available categories.cantonstringSwiss canton filter. Examples: Geneve, Vaud, Valais, Fribourg, Neuchatel, Berne, JuralocationstringCity name or postal code (NPA) — partial matchprice_minnumberMinimum price in CHF (inclusive)price_maxnumberMaximum price in CHF (inclusive)sortstringSort order: recent (newest first, default), price_asc, price_desc, viewslimitintegerResults per page (1–50, default 20)offsetintegerPagination offset. Use next_offset from previous response to get next page.
get_classified1 paramGet 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.
idintegerrequiredNumeric listing ID — visible in the URL and in search_classifieds results
get_categories1 paramList 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_idintegerFilter to direct children of this category ID. Omit for all categories. Use 0 for root categories only.
README.md
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
Recommended MCP Servers
How it compares
Regional classifieds search MCP, not a full ecommerce storefront or payment integration.
FAQ
What does Joomil - Swiss Classifieds MCP do?
Search Swiss classifieds on Joomil.ch - top marketplace in French-speaking Switzerland since 2007.
When should I use Joomil - Swiss Classifieds MCP?
User asks about Joomil - Swiss Classifieds MCP mcp, search swiss classifieds on joomil.ch - top marketplace in french-spea.
Is this MCP server safe to install?
Review the Security Audits panel on this page before installing in production.