Bazos-MCP

MCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl.

Features

• Search ads across all sections on Czech, Slovak, Austrian, and Polish 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", "sk", "at", or "pl"
• 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", "sk", "at", or "pl"
• ad_id: The ad ID

get_user_ratings

Get user ratings.

Arguments:

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

Sections

Code	Name
AU	Auto
DE	Deti
DU	Dum a Zahrada
EL	Elektro
FO	Foto
HU	Hudba
KN	Knihy
MO	Mobily
MT	Motorky
NA	Nabytek
OB	Obleceni
PC	PC
PR	Prace
RE	Reality
SL	Sluzby
SP	Sport
ST	Stroje
VS	Vstupenky
ZV	Zvirata
OS	Ostatni

Disclaimer

This project is not affiliated with or endorsed by Bazos.cz, Bazos.sk, Bazos.at, or Bazos.pl. 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.