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

Resources

• olx://tracked-searches — list all tracked searches

• olx://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 framework

• better-sqlite3 — SQLite for price tracking persistence

• zod — 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