Skip to main content
Glama

Bydleno

by cz.bydleno
OverviewDiscussionsAdmin

Server Details

Search Czech rental listings from 24 portals, merged into one offer per flat.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over 21 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL

TDQS

A4.5/5.0

Scored across 1 tool

Disambiguation5/5

There is only one tool, so no other tool can be confused with it. Its purpose as a rental search is stated clearly. Although ambiguity cannot be measured across tools, there is zero risk of misselection.

Naming Consistency5/5

The single tool name search_rentals follows a clear verb_noun convention and matches its function. With only one name, there are no inconsistent patterns to penalize.

Tool Count3/5

One tool is thin for a rental portal, but the search tool is parameterized enough to handle many requests. It is a borderline case rather than a severe under-provisioning.

Completeness3/5

The core search workflow is covered, but there is no pagination or per-listing detail tool; users are redirected to links for full results. This creates a dead end when an agent needs to inspect more offers or specific listing details.

Available Tools

1 tool
search_rentalsHledání pronájmů bytůA
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
penbNoPENB – energetický štítek budovy.
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).
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

ParametersJSON Schema
NameRequiredDescription
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.

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • Changedsearch_rentals2 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"
  2. 1 tool update
    • Changedsearch_rentals9 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."
  3. 1 tool update
    • Changedsearch_rentals2 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"
+}
  4. 1 tool update
    • First observedsearch_rentals

Related MCP Connectors

Related MCP Servers

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