Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the OLX in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Manage your OLX classifieds account (Poland, Romania, Bulgaria, Portugal, Ukraine, Kazakhstan, Uzbekistan) from Claude, ChatGPT or Copilot: your adverts with status, statistics and moderation reasons, buyer message threads with replies, wallet balance, billing and invoices, and categories, attributes and locations. OAuth sign-in, one install per country.
Try asking
Example prompts for OLX
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → OLX, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
OLX
Manage your OLX classifieds account (Poland, Romania, Bulgaria, Portugal, Ukraine, Kazakhstan, Uzbekistan) from Claude, ChatGPT or Copilot: your adverts with status, statistics and moderation reasons, buyer message threads with replies, wallet balance, billing and invoices, and categories, attributes and locations. OAuth sign-in, one install per country.
Setup
Setting up takes about 10 minutes, plus the time OLX needs to review your application. You need an OLX account on the country site you sell on and an application accepted on that country's OLX developer portal.
- Sign in with your OLX account at the developer portal of your country: developer.olx.pl (Poland), developer.olx.ro (Romania), developer.olx.bg (Bulgaria), developer.olx.pt (Portugal), developer.olx.ua (Ukraine), developer.olx.kz (Kazakhstan) or developer.olx.uz (Uzbekistan).
- Add an application with Connect App. As redirect URI (on the Polish portal: Adres powrotu) enter
https://cloud.anythingmcp.com/api/mcp-oauth/callbackon AnythingMCP Cloud, or<your AnythingMCP URL>/api/mcp-oauth/callbackwhen you host AnythingMCP yourself. - Wait for OLX to accept the application. Until then it shows Waiting for acceptance; OLX emails you, and only after acceptance do the Client ID and Client Secret appear.
- Paste them into
OLX_CLIENT_IDandOLX_CLIENT_SECRET, and setOLX_HOSTto your country's site exactly, for examplehttps://www.olx.pl,https://www.olx.roorhttps://www.olx.ua, without a path or trailing slash. It must be the country where the application was registered. - Install the connector, open it and click Authorize with Provider. Sign in with the OLX account whose adverts the AI should see and approve the access (the connector asks for the scopes
v2 read write). Then runolx_get_me: it shows the signed-in user and confirms thatOLX_HOSTis the right country.
One install per country: each OLX country is its own site with its own accounts, app registration and categories. If you sell in Poland and in Romania, install the connector twice and put the country in its name. OLX Brazil runs on a different platform and is not covered.
Whose account it is: everyone using this connector reads the adverts and messages of the account that authorized it. Use the seller account, and decide who gets the connector before you share it.
What it reads: your own adverts with status (active, limited, outdated, moderated or blocked), title, price, category, location, contact, validity dates and link; full advert details with description, attributes and images; statistics per advert (views, phone number reveals, favourites); why moderation rejected or blocked an advert; the paid features currently active on an advert; message threads with buyers and their unread counts, the messages in them and the public profile of the other person; your business profile; your OLX wallet balance and bonus credits, billing history and prepaid and postpaid invoices; and the lookups an advert needs: categories with their required attributes, a category suggestion from an advert title, regions, cities, districts and the city that matches a pair of coordinates.
Only your own adverts: OLX has no API for searching other people's adverts, so the AI cannot browse the marketplace or look up competitors' listings.
Switched off at install: olx_send_message, olx_mark_thread_read, olx_deactivate_advert and olx_delete_advert. A message reaches a real buyer at once and cannot be taken back; deactivating takes a listing off the site (reactivating may cost a fee, so it is not offered here); deleting removes an advert with its statistics and messages for good. An administrator switches on only the ones the team needs.
Asks before every change: with a write tool switched on, the AI shows you the thread and the exact text, or the advert, and waits for your yes before it sends anything or takes a listing down.
Messages are untrusted: a buyer's message can contain instructions aimed at the AI. The AI treats message texts as content to read, not as commands.
Limits: OLX allows about 4,500 requests per 5 minutes per IP address and blocks the address for 30 minutes beyond that, so the AI pages through long lists at a calm pace instead of looping fast.
Common errors: 401 invalid_token means the sign-in expired or was revoked: click Authorize with Provider again. invalid_client at sign-in means the application is not accepted yet, or the Client ID and Secret come from another country's portal. 404 means the advert, thread or user is not visible to the signed-in account; for the business profile it means the account is not a business account.
The connector does not create, edit, activate or promote adverts, buy paid features or packets, or spend anything from the OLX wallet: those stay on the OLX site.
Prerequisites: OLX_HOST, OLX_CLIENT_ID, OLX_CLIENT_SECRET
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick OLX and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
olx_get_me | Read the OLX user the connector is signed in as: id, email, name, status, phone and account type |
olx_get_user | Read the public profile of another OLX user by id (name, avatar, when they joined), e.g. the person behind a message thread… |
olx_get_business_profile | Read the business profile of the signed-in account (company name, description, address, website, logos and banners) |
olx_get_account_balance | Read the account's OLX wallet: the balance and bonus credits available for paid features and packets, by currency |
olx_list_billing | List the account's billing history: what was charged for adverts, paid features and packets, with date, amount and the advert concerned |
olx_list_prepaid_invoices | List the account's prepaid invoices (top-ups and prepaid purchases) with number, date, amount and download link |
olx_list_postpaid_invoices | List the account's postpaid invoices (for business accounts billed after the fact) with number, date, amount and download link |
olx_list_adverts | List the signed-in account's own adverts (listings) with id, status (for example active, limited, outdated, moderated or blocked), title… |
olx_get_advert | Get one of the account's adverts by id with all fields: title, description, category and attributes, price, images, location, contact… |
olx_get_advert_statistics | Read an advert's statistics: page views, phone number reveals and how many users saved it as a favourite |
olx_get_advert_moderation_reason | Read why OLX moderation rejected or blocked an advert (status moderated or blocked), so the user can fix it |
olx_list_advert_paid_features | List the paid features (promotions such as top ads or refreshes) currently active on an advert, with their end dates |
olx_list_threads | List the account's message threads with buyers and sellers: thread id, advert id, the other person (interlocutor_id), total and unread… |
olx_get_thread | Get one message thread by id: advert, the other person, message counts, unread state and favourite flag |
olx_list_messages | Read the messages of a thread, with text, sender type (sent or received), time, read state and attachments |
olx_list_categories | List OLX categories of this country with id, name, parent and whether adverts can be posted in it |
olx_get_category | Get one category by id: name, parent, whether it is a leaf you can post in, and its photo and price rules |
olx_get_category_attributes | List the attributes an advert in this category needs or may have (e.g. size, condition, brand), with code, label, type, whether required… |
olx_suggest_category | Suggest the best OLX categories for an advert title, e.g. iphone 13 128gb |
olx_list_regions | List the regions (voivodeships, counties, oblasts) of this OLX country with id and name |
olx_list_cities | List cities of this OLX country with id, name, region, county, municipality and coordinates |
olx_get_city_districts | List the districts of a city (for larger cities that have them), with id and name, for an advert's location |
olx_find_location | Find the OLX city and district for a latitude and longitude, to set an advert's location |
olx_send_message | Send a message in an existing thread, as the signed-in account, to the buyer or seller on the other side |
olx_mark_thread_read | Mark every message of a thread as read for the signed-in account |
olx_deactivate_advert | Take an active advert off OLX (it stops being visible to buyers). is_success true tells OLX the item was sold through OLX |
olx_delete_advert | Delete an advert for good, with its statistics and messages |
Example prompts
- "Which of my adverts were moderated or blocked, and what does OLX say I need to fix?"
- "Which buyer threads have unread messages? Summarise what each buyer is asking about."
- "Show views, phone reveals and favourites for my active adverts, and tell me which ones get the least attention."
- "How much is left in my OLX wallet, and what was I charged for in the last month?"
- "I want to sell a used iPhone 13 128 GB in Warsaw: which category fits, and which attributes are required there?"
Next steps
Was this guide helpful?