OLX MCP Server

Why search for e-waste in your area by yourself if Claude can do it for you?

100% AI slop.

Features

• 🌍 Multi-Domain Support: Search across 5 OLX domains (Portugal, Poland, Bulgaria, Romania, Ukraine)
• 🔍 Search Listings: Search with filters for category, location, price range, and sorting
• 📋 Listing Details: Get detailed information about specific listings including seller info
• 🎭 Browser Automation: Reliable web scraping using Playwright

Installation

📋 Claude Desktop Configuration

1. Locate your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the OLX MCP server to your configuration:

{
  "mcpServers": {
    "olx-mcp": {
      "command": "npx",
      "args": ["olx-mcp"]
    }
  }
}

1. Restart Claude Desktop to load the new configuration.

🔄 Alternative: Global Installation

If you prefer to install globally:

npm install -g olx-mcp

Then use this config:

{
  "mcpServers": {
    "olx-mcp": {
      "command": "olx-mcp"
    }
  }
}

📦 Development: From Source

git clone https://github.com/l-margiela/olx-mcp.git
cd olx-mcp
npm install
npm run build

Use this config for development:

{
  "mcpServers": {
    "olx-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/olx-mcp/dist/index.js"]
    }
  }
}

Usage

Once configured, you can use the following tools in your MCP client:

Search Listings

Search for listings on any supported OLX domain with various filters:

Can you search for "apartments" in "Lisboa" on OLX Portugal with a maximum price of 1000 euros?

Search for "telefon" in "warszawa" on OLX Poland with prices between 100-500 PLN?

Parameters:

• domain (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')
• query (optional): Search term
• category (optional): Category filter
• location (optional): Location filter
• minPrice (optional): Minimum price
• maxPrice (optional): Maximum price
• page (default: 1): Page number
• limit (default: 20): Items per page
• sortBy (default: 'relevance'): Sort order ('relevance', 'date', 'price-asc', 'price-desc')

Listing Details

Get detailed information about a specific listing from any supported domain:

Can you get the details for listing "ABC123" from OLX Portugal?

Show me details for listing "XYZ789" from OLX Poland including images?

Parameters:

• domain (required): OLX domain ('olx.pt', 'olx.pl', 'olx.bg', 'olx.ro', 'olx.ua')
• listingId (required): The ID of the listing
• includeImages (default: true): Include the listing's gallery image URLs
• includeSellerInfo (default: true): Include seller information

Development

Scripts

• npm run build - Build the TypeScript project
• npm run dev - Run in development mode with hot reload
• npm start - Run the built server
• npm test - Run tests (when available)
• npm run clean - Clean build artifacts

Releasing

Releases are automated. Pushing a v* tag triggers .github/workflows/release.yml, which runs the full CI pipeline, publishes to npm (with provenance), and creates the GitHub Release:

npm version patch   # or minor/major; creates the version commit + v-tag
git push origin main --follow-tags

Do not run npm publish manually — CI publishes on the tag push, so a local publish always fails with "cannot publish over previously published versions". Verify with gh run list (green "Release" run) and gh release view vX.Y.Z.

Troubleshooting

MCP Inspector

For debugging MCP communication, you can use the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT License - see LICENSE file for details.