About Olx MCP
Olx MCP is an MCP server in the Search category: oLX MCP server.
The repository has 24 stars and 0 forks.
Install
git clone https://github.com/tkupcewicz/olx-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
compare_offersSide-by-side comparison of 2–10 offers
Parameters not published.
get_categoriesBrowse category tree with IDs for filtering searches
Parameters not published.
get_offerGet full offer details — description, params, images, seller info
Parameters not published.
get_price_historyView price trends for tracked searches (auto-refreshes if stale)
Parameters not published.
search_offersSearch listings with query, category, location, price range, sorting, and pagination
Parameters not published.
track_searchSave search criteria and take an initial price snapshot
Parameters not published.
Ask AI
Ask AI about Olx MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
OLX MCP Server
MCP 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.
Uses the OLX internal frontend API (read-only, no auth required).
Tools
| Tool | Description |
|---|---|
search_offers |
Search listings with query, category, location, price range, sorting, and pagination |
get_offer |
Get full offer details — description, params, images, seller info |
get_categories |
Browse category tree with IDs for filtering searches |
track_search |
Save search criteria and take an initial price snapshot |
get_price_history |
View price trends for tracked searches (auto-refreshes if stale) |
compare_offers |
Side-by-side comparison of 2–10 offers |
Resources
olx://tracked-searches— list all tracked searchesolx://tracked-searches/{id}— detail + price snapshots for a tracked search
Setup
npm install
Claude Code
The repo includes .mcp.json — Claude Code will pick it up automatically when you open the project directory.
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"olx": {
"command": "npx",
"args": ["tsx", "src/index.ts"],
"cwd": "/path/to/olx-mcp"
}
}
}
MCP Inspector
npx @modelcontextprotocol/inspector npx tsx src/index.ts
Supported Countries
pl (default), bg, ro, pt, ua, kz
Pass country parameter to any tool to switch. Category data is curated for Poland; other countries use auto-discovery from search results.
Tech Stack
- TypeScript / Node.js (ESM)
@modelcontextprotocol/sdk— MCP server frameworkbetter-sqlite3— SQLite for price tracking persistencezod— input validation- Token bucket rate limiter (4000 req / 5 min per country)
Development
npm run dev # run with tsx
npm run build # compile TypeScript
npm start # run compiled JS
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.