Olx MCP

🚀 OLX MCP Server

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

100% AI slop.

🚀 Quick Start

This server enables you to search for listings on multiple OLX domains with the help of Claude. After proper configuration, you can use various commands in your MCP client to perform searches and obtain listing details.

✨ 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"]
    }
  }
}

3. 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 Examples

Basic Usage

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:

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:

🔧 Technical Details

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.

🐞 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.