mcpField
B
bazos-mcp

bazos-mcp

Local
github.com/andrijdavidBusiness & Marketing4Updated 4w ago
Repository

About bazos-mcp

bazos-mcp is an MCP server for searching listings and retrieving ad details and user ratings on Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Its search supports category, price, sorting, and location filters.

Key features

  1. 01Search ads across four Bazos sites
  2. 02Filter by section and price range
  3. 03Sort by date, price, or distance
  4. 04Retrieve full ad details
  5. 05Fetch user ratings by phone or email ID

Use cases

  1. 01Search listings across Czech, Slovak, Austrian, and Polish sites
  2. 02Find ads within a price range or near a location
  3. 03Inspect an ad's full details
  4. 04Check a seller's ratings

MCP support

It exposes tools to MCP clients for searching ads, retrieving ad details, and fetching user ratings across the four Bazos sites.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "andrijdavid-bazos": {
      "command": "npx",
      "args": [
        "-y",
        "@andrijdavid/bazos-mcp"
      ]
    }
  }
}
Run commandnpx -y @andrijdavid/bazos-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@andrijdavid/bazos-mcp0.1.2

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
sortstringNoSort type. Available: date, price_asc, price_desc, distance. For distance, provide latitude and longitude.
limitnumberNoLimit for pagination. Default: 20. Must be a multiple of 20 up to 200.
querystringNoSearch query string
domainenumYesDomain to search: cz or skcz | sk
offsetnumberNoOffset for pagination. Default: 0. Must be a multiple of 20.
sectionstringNoSection code. Available: 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
latitudenumberNoLatitude (required when sort is distance)
price_tonumberNoMaximum price
longitudenumberNoLongitude (required when sort is distance)
price_fromnumberNoMinimum price

Details

From the project README

Bazos-MCP

npm version npm downloads License: AGPL-3.0 Release Node.js

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

CodeName
AUAuto
DEDeti
DUDum a Zahrada
ELElektro
FOFoto
HUHudba
KNKnihy
MOMobily
MTMotorky
NANabytek
OBObleceni
PCPC
PRPrace
REReality
SLSluzby
SPSport
STStroje
VSVstupenky
ZVZvirata
OSOstatni

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.