OLX MCP
Server Details
OLX.pl classifieds in every category: property, cars, electronics, jobs, free items; offer details.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: category tree lookup, offer search, and single-offer details. Descriptions explicitly cross-reference each other (e.g., olx_categories finds category_id for olx_search), leaving no ambiguity.
All tool names follow a consistent olx_ + noun pattern (olx_categories, olx_offer, olx_search) with uniform snake_case. The convention is predictable and easy to remember.
Three tools are exactly what a read-only classifieds search integration needs: browse categories, search offers, and inspect individual offers. Each tool earns its place without redundancy.
The surface covers the full read-only lifecycle: find a category, search offers with filtering and pagination, and retrieve full details for a specific offer. No essential operation is missing for the stated search-and-browse purpose.
Available Tools
3 toolsolx_categoriesBrowse OLX.pl categoriesAInspect
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').
Inputs: query, no_cache, parent_id.
olx_offerGet one OLX.pl offerAInspect
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 } }.
Inputs: id (required), no_cache.
olx_searchSearch OLX.pl classifiedsAInspect
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 budget rather than an asking price, 'free' = giveaway with value 0, 'exchange' = swap with value null — so never read a missing amount as 0 PLN. per ('hour' | 'day' | 'night' | 'week' | 'month') marks a rate, e.g. equipment rented at 150 PLN per day — the value is then not a total. previous_value appears after a price drop. Jobs carry salary { from, to, currency, period, gross } instead of a price. params maps each attribute's key to its Polish display label (e.g. { state: 'Używane', m: '44,60 m²', rooms: '2 pokoje' }) — the keys are what filters use. description is a short excerpt; contact details are never included. An empty match answers count: 0 with a note saying why and what to change — a successful result, not an error.
Inputs: limit, query, offset, region, +11 more. Returns: note, count, limit, query, +7 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Polish property on Otodom.pl: flats, houses, rooms, plots, commercial to buy or rent; offer details.
Polish property listings on nieruchomosci-online.pl: flats, houses, plots, premises to buy or rent.
Real estate in Poland: about 5,000 property listings for sale and rent, plus local businesses
Polish property on Gratka.pl/Morizon.pl (one database): flats, houses, plots, premises, buy or rent.
Related MCP Servers
- -licenseNot gradedqualityBmaintenanceEnables AI assistants to search the Polish classifieds site OLX.pl anonymously, resolving locations, categories and listing URLs, retrieving full offer details, and downloading offer photos as images. Every offer includes a description-quality check that flags weak listings so the model can inspect the photos and report the item's actual condition.-
- FlicenseNot gradedqualityDmaintenanceMCP server for OLX marketplace. Enables AI assistants to search listings, get offer details, track prices over time, and compare offers across OLX Poland and other supported countries.4-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search and inspect Polish real estate listings (apartments, houses, plots, commercial premises, garages, and rooms for sale or rent) plus developer investments and notarial transaction prices. Also supports looking up around 954,000 local businesses and places by name, category, city, or proximity, complete with addresses, opening hours, and canonical links.MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to search and retrieve detailed classified listings, including specifications, images, and seller info, from OLX India.25 npm2MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.