# OLX MCP (remote · mcp.wondel.ai)

OLX.pl classifieds in every category: property, cars, electronics, jobs, free items; offer details.

- Trust score: 57/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `mcp.wondel.ai`: 57/100 (this document), [markdown](https://verifymcp.io/servers/ai-wondel-olx/olx-mcp.md), [page](https://verifymcp.io/servers/ai-wondel-olx/olx-mcp)

## Channel facts

- Endpoint: `https://mcp.wondel.ai/olx/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 3 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS enforcement could not be verified: the plaintext port answered with HTTP 405, which proves neither a plaintext path nor enforcement.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 49/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2053 tokens (~684/item across 3 items; 3 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 10/100
  - Stability observed for 3 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (33% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 3 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 4 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the OLX MCP server?

OLX MCP is a hosted endpoint at https://mcp.wondel.ai/olx/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http ai-wondel-olx 'https://mcp.wondel.ai/olx/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "ai-wondel-olx": {
      "url": "https://mcp.wondel.ai/olx/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "ai-wondel-olx": {
      "type": "http",
      "url": "https://mcp.wondel.ai/olx/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.ai-wondel-olx]
url = "https://mcp.wondel.ai/olx/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-wondel-olx": {
      "type": "remote",
      "url": "https://mcp.wondel.ai/olx/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-wondel-olx --url 'https://mcp.wondel.ai/olx/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-wondel-olx:
    url: "https://mcp.wondel.ai/olx/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "ai-wondel-olx": {
      "Transport": "http",
      "Url": "https://mcp.wondel.ai/olx/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add ai-wondel-olx -t streamable-http -u 'https://mcp.wondel.ai/olx/mcp'
```

### Other

```json
{
  "mcpServers": {
    "ai-wondel-olx": {
      "type": "http",
      "url": "https://mcp.wondel.ai/olx/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 56, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-02 (score 55)

First indexed and scored.

## MCP tools (3)

### `olx_search` (~1383 tokens)

Search OLX.pl classifieds

Search offers on OLX.pl, Poland's largest classifieds site, across every category: flats and houses for rent or sale, cars and parts, phones and electronics, furniture, clothes, jobs, services, free items. Filter by words, category, place (city or district, with a radius) or voivodeship, price range, new/used, private vs business seller, and any category-specific attribute via `filters`. Common category_id values: Nieruchomości 3 (flats for rent 15, flats for sale 14, houses for rent 20, houses for sale 18, rooms 11, plots 709), Motoryzacja 5 (passenger cars 84, motorcycles 81, car parts 82), Elektronika 99 (smartphones 1839, laptops 1199, TVs 1849, game consoles 1604), Dom i Ogród 628 (furniture 565), Moda 87, Dla Dzieci 88, Sport i Hobby 767 (bicycles 461), Zwierzęta 103, Praca 4 (jobs), Usługi 4371, Oddam za darmo 1151 (free items). olx_categories lists the full tree and shows which categories a query's offers fall in. Pass an offer's `id` to olx_offer for the full description, all photos and map location. Fetched live from OLX.pl's public API (typically well under 1 s; a few seconds when it falls back to an unblocker). Result shape: { source, fetchedAt, query, resolved_location, total_count, offset, limit, next_offset, count, offers: [...], note? } — the list key is `offers`; `total_count` counts all matches, but OLX pages through only the first 1000 (pass `next_offset` as `offset` for more). Each offer: { id, url, title, price: { value, currency, negotiable, type, label, per?, previous_value? } | null, salary?, area_m2?, rooms?, params, city, district, region, category_id, category, seller_type, promoted, created_time, refreshed_time, photo, photos_count, description, external_url? }. `price.value` is a number in `currency` (PLN) or null when there is no amount. `price.type`: 'price' = the asking price (`negotiable` when the seller accepts offers; for flat/house rentals the monthly rent), 'arranged' (to be agreed) with value null, 'budget' = the advertiser's b…

Input parameters:

- `category_id` (integer): OLX category id (see the list above or olx_categories), e.g. 15 = flats for rent.
- `condition` (string): Item condition (Stan) — goods categories only (electronics, fashion, home…).
- `distance_km` (integer): Also include offers within this radius of location, in km (OLX offers 2, 5, 10, 15, 30, 50, 75, 100).
- `filters` (object): Category-specific OLX filters (requires category_id). Keys come from an offer's `params` keys: 'filter_float_<key>:from' / ':to' for numbers, 'filter_enum_<key>' for choices (value or list of option…
- `include_promoted` (boolean): Also return OLX's paid top-ad slots (flagged promoted: true). They repeat across pages and ignore sort_by, so they are left out by default.
- `limit` (integer): Results per call, 1–50. Default 20.
- `location` (string): Polish name of a city, town or village, optionally followed by a district: 'Kraków', 'Warszawa Mokotów', 'Gdańsk Wrzeszcz'. English names ('Warsaw') are not recognised; a partial name returns suggest…
- `no_cache` (boolean): Force a fresh fetch and bypass this server's result cache (5 min). Default false.
- `offset` (integer): Skip this many results (0–1000; OLX pages through the first 1000 only). Default 0.
- `owner_type` (string): 'private' = private individuals only; 'business' = companies/agencies only.
- `price_from` (number): Minimum price in PLN (monthly rent for rentals).
- `price_to` (number): Maximum price in PLN (monthly rent for rentals).
- `query` (string): Search words, matched loosely against titles and descriptions. Polish terms work best ('rower górski', 'kawalerka', 'iphone 13 pro'). Omit to browse a category/place.
- `region` (string): Voivodeship. Alone: search the whole voivodeship. With location: picks among same-name places.
- `sort_by` (string): 'relevance', 'newest' (most recently posted or refreshed first), 'price_asc' (cheapest first) or 'price_desc'. Default: OLX's own ordering.

Output parameters:

- `count` (number)
- `fetchedAt` (string)
- `limit` (number)
- `next_offset`
- `note`
- `offers` (array)
- `offset` (number)
- `query` (object)
- `resolved_location`
- `source` (string)
- `total_count`

### `olx_offer` (~321 tokens)

Get one OLX.pl offer

Full details of one OLX.pl offer: price (or salary for a job), every attribute with its Polish name and value (area, rooms, rent, condition, model, year, mileage…), the full description, all photo URLs, location (city, district, voivodeship, map coordinates — often approximate), seller type and public name (company, or the first name a private seller shows), posting/refresh/expiry times, OLX delivery availability, and the original otodom.pl link for partner property listings. No contact details. Fetched live from OLX.pl's public API (typically well under 1 s; a few seconds when it falls back to an unblocker). Result: { source, fetchedAt, offer: { id, url, title, status, category_id, category, price, salary?, area_m2?, rooms?, params: [{ key, name, value }], description, location: { city, city_id, district, district_id, region, region_id, lat, lon, approximate }, seller: { type, name, member_since }, created_time, refreshed_time, valid_to_time, promotion, olx_delivery, photos, external_url } }.

Input parameters:

- `id` (required): The offer's numeric id (e.g. 1100381308) or its OLX URL (…-CID3-ID1ct5rC.html), as returned by olx_search.
- `no_cache` (boolean): Force a fresh fetch and bypass this server's result cache (5 min). Default false.

### `olx_categories` (~247 tokens)

Browse OLX.pl categories

Find the category_id for olx_search. Without arguments: OLX's 19 top-level categories. With parent_id: that category's sub-categories (instant, from a snapshot of OLX's category tree). With query: which categories the offers matching those words fall in, with live offer counts, largest first — the quickest way to pick a category for a search term (e.g. 'iphone 13' → Smartfony i telefony komórkowe > iPhone). Result: { source, parent, query?, total_count?, count, categories: [{ id, name, path, has_children, count? }] } — `path` is the full Polish name trail ('Nieruchomości > Mieszkania > Wynajem').

Input parameters:

- `no_cache` (boolean): Force a fresh fetch and bypass this server's result cache (5 min). Default false.
- `parent_id` (integer): List this category's sub-categories (e.g. 3 = Nieruchomości). With query: scope the counts to it.
- `query` (string): Search words; returns the categories their offers fall in, with counts (one live request).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-wondel-olx/olx-mcp#diagnostics

## Score history

- 2026-11-05: 57
- 2026-11-04: 56
- 2026-11-03: 56
- 2026-11-02: 55

## Common questions

### What is the OLX MCP server?

OLX MCP is listed in the public MCP registry as ai.wondel/olx. OLX.pl classifieds in every category: property, cars, electronics, jobs, free items; offer details. This page covers its hosted endpoint (https://mcp.wondel.ai/olx/mcp).

### Is the OLX MCP server safe to use?

OLX MCP scores 57 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the OLX MCP server expose?

OLX MCP exposes 3 tools: olx_search, olx_offer, olx_categories. Their descriptions and schemas cost roughly 1,951 tokens of context every time the server is loaded.

### Does the OLX MCP server require authentication?

No. We connected to OLX MCP without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the OLX MCP server still maintained?

OLX MCP is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://mcp.wondel.ai/olx/mcp
- Website: https://mcps.wondel.ai/servers/olx/
- Changelog RSS feed: https://verifymcp.io/servers/ai-wondel-olx/olx-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-wondel-olx/olx-mcp.json
- HTML version of this page: https://verifymcp.io/servers/ai-wondel-olx/olx-mcp