OLX

You can run the OLX MCP Server to perform cross-domain OLX searches and fetch detailed listing information through a flexible MCP client. It leverages browser automation for reliable scraping and exposes practical search and detail capabilities across multiple OLX domains.

How to use

To start using the OLX MCP Server, configure your MCP client to point at one of the provided MCP servers and then issue search and listing detail requests. You can search across multiple OLX domains using filters like category, location, and price, then retrieve detailed information for a specific listing.

Common workflows you can perform include: searching for listings with filters, and requesting detailed information for a single listing. For searches, you can specify a domain (for example olx.pt or olx.pl), a query, and optional filters such as location, minimum/maximum price, and sort order. For listing details, you provide the domain and the listing ID, and you can choose to include image URLs and seller information.

How to install

Prerequisites you need before installing include Node.js and npm. Ensure Node.js is installed and accessible from your command line.

Choose one of the installation approaches below and follow the exact commands in sequence.

Option A: Claude Desktop configuration (via a local config file) adds an MCP server using npx.

Option B: Global installation installs the MCP package globally and configures it to run as a local command.

Option C: Development setup builds from source for local development.

Code examples and configurations

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

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

npm install -g olx-mcp

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

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

Troubleshooting and notes

If you need debugging help, you can use the MCP Inspector to debug MCP communication. Run the inspector with the Node.js runtime and the built dist entry point.

Available tools

search_listings

Search across one or more OLX domains with filters for category, location, price range, and sorting to return matching listings.

listing_details

Retrieve detailed information about a specific listing, including optional image URLs and seller information.

domain_support

Support for multiple OLX domains such as olx.pt, olx.pl, olx.bg, olx.ro, and olx.ua to enable cross-domain querying.