Skip to main content
Glama

Bydleno

Hledání pronájmů bytů

search_rentals
Read-only

Najde pronájmy bytů v Česku podle zadaných kritérií. Vrátí prvních deset nabídek, celkový počet a odkaz na celý výpis na bydleno.cz. Všechny parametry jsou volitelné a bez nich dostaneš nejnovější nabídky; zadávej jen ta kritéria, která uživatel řekl. Nejčastěji stačí location_texts, layout_id a price_range_to. Hodnoty výčtů piš přesně jako popisky ze schématu ("2+kk", "Vybavený"); hodnotu mimo výčet i neznámý parametr zahodíme. Místa (kraje, okresy, obce, městské části, čtvrti, ulice, adresy) předávej česky v 1. pádě v poli location_texts ("Praha 1", ne "Prague 1"), nejvýš deset; místo, které nerozpoznáme, hledáme v textu inzerátu. Když nic neodpovídá, vrátí nulový počet a odkaz na výpis; když hledání selže, vrátí isError a text chyby. Vždy nabídni uživateli odkaz na výpis i na jednotlivé nabídky.

Input Schema

NameRequiredDescriptionDefault
penbNoPENB – energetický štítek budovy.
auctionNoDražba nebo aukce – chci jen dražby (true), nechci dražby (false).
keywordsNoVe většině dotazů zůstává prázdné. Jen slovo, které uživatel sám napsal, popisuje konkrétní vlastnost bytu, nemá vlastní pole a čekáš, že ho majitel napsal i v popisu inzerátu. Slovo, kterému nerozumíš, překlep ani zbytek sousloví sem nepatří – ty dej do unsupported; název místa patří do location_texts.
amenitiesNoVybavení a příslušenství bytu, které uživatel chce (balkon, garáž, sklep, výtah, pračka, myčka, klimatizace…). "vnitroblok" znamená byt orientovaný okny do klidného vnitrobloku, ne do ulice. Vyber jen ta, která uživatel zmínil.
conditionNoStav
layout_idNoDispozice
shareableNoCelý byt vhodný ke spolubydlení (true).
last_floorNoPoslední patro – chci (true), nechci (false).
room_shareNoSpolubydlení – pokoj ve sdíleném bytě (true).
svetly_bytNoSvětlý byt podle naší analýzy fotek inzerátu. Filtruje jen při true.
pod_odhademNoNájem pod naším odhadem obvyklé ceny srovnatelných bytů. Filtruje jen při true.
furnished_idNoVybavenost
ground_floorNoPřízemí – chci přízemí (true), nechci přízemí (false).
pets_allowedNoZvířata povolená (true), nebo bez zvířat (false).
area_range_toNoPlocha (m²) – do
available_fromNoNejpozdější datum nastěhování ve formátu YYYY-MM-DD.
has_commissionNoNabídka je s provizí (true), nebo bez provize (false). "bez RK", "bez realitky", "bez realitní kanceláře" a "přímo od majitele" znamenají bez provize (false).
location_textsNoNázvy míst v základním tvaru (1. pád) – např. "Brno" (ne "Brně"), "Praha 1", "Vinohrady", "Vinohradská". Patří sem názvy krajů, okresů, měst a obcí, městských částí, čtvrtí, katastrálních území, ulic i adres – i těch, které neznáš.
long_term_onlyNoJen dlouhodobý pronájem (true), nebo i krátkodobý (false).
price_range_toNoCena (Kč za měsíc) – do
area_range_fromNoPlocha (m²) – od
klidna_lokalitaNoKlidná lokalita podle hlukové mapy okolí adresy. Filtruje jen při true.
smokers_allowedNoKouření povolené (true), nebo nekuřácké (false).
available_withinNoJak brzy se chce nastěhovat. "ihned"/"co nejdřív" → Ihned.
price_range_fromNoCena (Kč za měsíc) – od
bezpecna_lokalitaNoBezpečná lokalita podle dat o kriminalitě v okolí adresy. Filtruje jen při true.
cardinal_directionsNoSvětová strana
unit_floor_range_toNoPatro – do
unit_floor_range_fromNoPatro – od
building_flats_range_toNoPočet bytů – do
building_floor_range_toNoPočet podlaží – do
nearby_place_to_type_idNoPoblíž vybraného typu místa ("chci to blízko restaurace, metra").
nearby_place_distance_toNoNejvýš jak daleko smí být blízké místo.
building_flats_range_fromNoPočet bytů – od
building_floor_range_fromNoPočet podlaží – od
nearby_place_from_type_idNoDaleko od vybraného typu místa ("daleko od baru, benzínky").
nearby_place_distance_fromNoNejméně jak daleko musí být nechtěné místo.

Output Schema

NameRequiredDescriptionDefault
totalYesKolik nabídek kritériím odpovídá celkem, ne jen v results.
resultsYesPrvních deset nabídek.
listing_urlYesOdkaz na celý výpis na bydleno.cz se stejnými filtry.
unverified_criteriaYesKritéria, u kterých výpis pouští i nabídky s chybějícím údajem. U nich neplatí, že je vlastnost doložená — neříkej to uživateli jako fakt.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / auction
      Added value: +{
      +  "description": "Dražba nebo aukce – chci jen dražby (true), nechci dražby (false).",
      +  "type": "boolean"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / has_commission / description
      Previous value: -"Nabídka je s provizí (true), nebo bez provize (false)."New value: +"Nabídka je s provizí (true), nebo bez provize (false). \"bez RK\", \"bez realitky\", \"bez realitní kanceláře\" a \"přímo od majitele\" znamenají bez provize (false)."
  3. Changed2 schema fields changed
    • changedInput schema / properties / building_floor_range_from / description
      Previous value: -"Patra budovy – od"New value: +"Počet podlaží – od"
    • changedInput schema / properties / building_floor_range_to / description
      Previous value: -"Patra budovy – do"New value: +"Počet podlaží – do"
  4. Changed9 schema fields changed
    • changedInput schema / properties / area_range_from / description
      Previous value: -"Plocha – od"New value: +"Plocha (m²) – od"
    • changedInput schema / properties / area_range_to / description
      Previous value: -"Plocha – do"New value: +"Plocha (m²) – do"
    • changedInput schema / properties / bezpecna_lokalita / description
      Previous value: -"Bezpečná lokalita"New value: +"Bezpečná lokalita podle dat o kriminalitě v okolí adresy. Filtruje jen při true."
    • changedInput schema / properties / klidna_lokalita / description
      Previous value: -"Klidná lokalita"New value: +"Klidná lokalita podle hlukové mapy okolí adresy. Filtruje jen při true."
    • changedInput schema / properties / penb / description
      Previous value: -"PENB"New value: +"PENB – energetický štítek budovy."
    • changedInput schema / properties / pod_odhadem / description
      Previous value: -"Pod odhadem ceny"New value: +"Nájem pod naším odhadem obvyklé ceny srovnatelných bytů. Filtruje jen při true."
    • changedInput schema / properties / price_range_from / description
      Previous value: -"Cena – od"New value: +"Cena (Kč za měsíc) – od"
    • changedInput schema / properties / price_range_to / description
      Previous value: -"Cena – do"New value: +"Cena (Kč za měsíc) – do"
    • changedInput schema / properties / svetly_byt / description
      Previous value: -"Světlý byt"New value: +"Světlý byt podle naší analýzy fotek inzerátu. Filtruje jen při true."
  5. Changed2 schema fields changed
    • changedInput schema / properties / available_from / description
      Previous value: -"Nejdřívější datum nastěhování ve formátu YYYY-MM-DD."New value: +"Nejpozdější datum nastěhování ve formátu YYYY-MM-DD."
    • addedInput schema / properties / available_within
      Added value: +{
      +  "description": "Jak brzy se chce nastěhovat. \"ihned\"/\"co nejdřív\" → Ihned.",
      +  "enum": [
      +    "Ihned",
      +    "Do měsíce",
      +    "Do dvou měsíců"
      +  ],
      +  "type": "string"
      +}
  6. First observed

TDQS

A5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

It details several operational behaviors not captured by annotations: what happens when no matches are found, the result limits (top ten listings), and the error reporting mechanism (`isError`). This level of detail is exceptionally helpful for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is information-dense but exceptionally well-structured. Every sentence contributes specific rules for parameter usage, output behavior, or failure modes, ensuring no part is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the high parameter count and detailed input requirements (especially linguistic and filtering rules), the definition is functionally complete. It covers expected output and failure scenarios thoroughly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

While schema coverage is 100%, the description adds vital semantic constraints, notably the linguistic requirement for location names to be in Czech Case 1, and instructions on how to handle keywords vs. structured data.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description starts with a clear, actionable purpose: finding rentals in the Czech Republic based on specified criteria. It leaves no ambiguity about the tool's primary function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit guidance on parameter optionality, advising users to only include criteria the agent is certain of. It also gives crucial formatting rules regarding expected input values.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources