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

Joomil — Swiss Classifieds MCP