Bazos MCP Server

Bazos-MCP

MCP server for interacting with Bazos.cz and Bazos.sk.

Features

• Search ads across all sections on both Czech and Slovak Bazos.
• Retrieve detailed ad information.
• Fetch user ratings by phone/email ID.

Installation

npm install -g @andrijdavid/bazos-mcp

Usage

Add to your MCP client configuration (e.g. Claude Desktop):

{
  "mcpServers": {
    "bazos": {
      "command": "npx",
      "args": ["-y", "@andrijdavid/bazos-mcp"]
    }
  }
}

Tools

search_ads

Search ads with filters.

Arguments:

• domain: "cz" or "sk"
• section: Section code (e.g. AU for Auto)
• query: Search query string
• price_from: Minimum price
• price_to: Maximum price
• sort: date, price_asc, price_desc, distance
• latitude / longitude: Required when sort is distance
• offset: Pagination offset (multiples of 20)
• limit: Page size (multiples of 20, max 200)

get_ad_detail

Get full details for an ad.

Arguments:

• domain: "cz" or "sk"
• ad_id: The ad ID

get_user_ratings

Get user ratings.

Arguments:

• domain: "cz" or "sk"
• phone: Phone ID
• email: Email ID
• offset: Pagination offset
• limit: Page size

Sections

Disclaimer

This project is not affiliated with or endorsed by Bazos.cz or Bazos.sk. The author is not responsible for any consequences arising from use of this software. The code is provided "as is", without warranty of any kind.

License

GNU AGPL-3.0. See LICENSE.