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

TableJSON Schema

Name	Required	Description
`penb`	No	PENB – energetický štítek budovy.
`keywords`	No	Ve 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.
`amenities`	No	Vybavení 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.
`condition`	No	Stav
`layout_id`	No	Dispozice
`shareable`	No	Celý byt vhodný ke spolubydlení (true).
`last_floor`	No	Poslední patro – chci (true), nechci (false).
`room_share`	No	Spolubydlení – pokoj ve sdíleném bytě (true).
`svetly_byt`	No	Světlý byt podle naší analýzy fotek inzerátu. Filtruje jen při true.
`pod_odhadem`	No	Nájem pod naším odhadem obvyklé ceny srovnatelných bytů. Filtruje jen při true.
`furnished_id`	No	Vybavenost
`ground_floor`	No	Přízemí – chci přízemí (true), nechci přízemí (false).
`pets_allowed`	No	Zvířata povolená (true), nebo bez zvířat (false).
`area_range_to`	No	Plocha (m²) – do
`available_from`	No	Nejpozdější datum nastěhování ve formátu YYYY-MM-DD.
`has_commission`	No	Nabídka je s provizí (true), nebo bez provize (false).
`location_texts`	No	Ná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_only`	No	Jen dlouhodobý pronájem (true), nebo i krátkodobý (false).
`price_range_to`	No	Cena (Kč za měsíc) – do
`area_range_from`	No	Plocha (m²) – od
`klidna_lokalita`	No	Klidná lokalita podle hlukové mapy okolí adresy. Filtruje jen při true.
`smokers_allowed`	No	Kouření povolené (true), nebo nekuřácké (false).
`available_within`	No	Jak brzy se chce nastěhovat. "ihned"/"co nejdřív" → Ihned.
`price_range_from`	No	Cena (Kč za měsíc) – od
`bezpecna_lokalita`	No	Bezpečná lokalita podle dat o kriminalitě v okolí adresy. Filtruje jen při true.
`cardinal_directions`	No	Světová strana
`unit_floor_range_to`	No	Patro – do
`unit_floor_range_from`	No	Patro – od
`building_flats_range_to`	No	Počet bytů – do
`building_floor_range_to`	No	Počet podlaží – do
`nearby_place_to_type_id`	No	Poblíž vybraného typu místa ("chci to blízko restaurace, metra").
`nearby_place_distance_to`	No	Nejvýš jak daleko smí být blízké místo.
`building_flats_range_from`	No	Počet bytů – od
`building_floor_range_from`	No	Počet podlaží – od
`nearby_place_from_type_id`	No	Daleko od vybraného typu místa ("daleko od baru, benzínky").
`nearby_place_distance_from`	No	Nejméně jak daleko musí být nechtěné místo.

Output Schema

TableJSON Schema

Name	Required	Description
`total`	Yes	Kolik nabídek kritériím odpovídá celkem, ne jen v results.
`results`	Yes	Prvních deset nabídek.
`listing_url`	Yes	Odkaz na celý výpis na bydleno.cz se stejnými filtry.
`unverified_criteria`	Yes	Krité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.

Changed2 schema fields changedSep 26, 2026
- 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"
```

Changed9 schema fields changedSep 16, 2026

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."

Changed2 schema fields changedSep 13, 2026

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"
+}

First observedSep 8, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Read-only annotations already cover safety, and the description adds substantial behavior beyond them: first-ten limit, empty-result behavior (zero count plus link), error behavior (isError with message), fallback to searching unrecognized places in ad text, and discarding unknown enum values/parameters. Nothing contradicts the readOnlyHint.

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?

Although the description is longer than average, it front-loads purpose and result and every sentence adds operational guidance (defaults, enum handling, location format, empty/error cases, link obligation). No filler or repetition.

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?

For a 36-parameter search tool with an output schema, the description covers all critical operational context: defaults, result limits, the most common parameter combination, value normalization, location semantics, and both empty and failure outcomes. Nothing important is missing.

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

Parameters4/5

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

Schema description coverage is 100%, so the baseline is 3. The description adds meaningful cross-cutting semantics: enum values must be exact schema labels, invalid/unknown values are dropped, locations must be Czech nominative forms in location_texts (max 10), and unrecognized locations fall back to ad-text search. This helps parameter selection beyond the schema.

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 opens with a specific verb and resource: 'Najde pronájmy bytů v Česku podle zadaných kritérií' (finds apartment rentals in Czechia by criteria), then states the result shape (first ten offers, total count, listing link). It is immediately clear what the tool does and what it returns.

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

Usage Guidelines4/5

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

It gives explicit context: all parameters are optional, no criteria returns newest offers, and only criteria the user stated should be passed. It also names the most useful parameters ('Nejčastěji stačí location_texts, layout_id a price_range_to') and explains enum and location formatting. There are no sibling tools or exclusions, so a top score for alternatives is not applicable.

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

All Bydleno tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?