Skip to main content
Glama

Somantic – German Real Estate Search

Estimate value

estimate_value
Read-only

Estimate what a German address is worth to buy and to rent.

Works for any address, listed or not. The estimate comes from comparable listings around it, so confidence and sample_size say how much to trust it - a thin sample means a wide, weakly supported band.

Returns estimate (point values, ranges and €/m² for price and rent) and confidence. A point estimate is absent when too few comparables back it; the €/m² band and sample_size still say what was found. This is a model output, not an appraisal, and no comparable listing is reproduced in it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cityYesCity name, e.g. "München".
floorNoFloor the flat is on.
roomsNoNumber of rooms (German count, e.g. 2.5). Improves the estimate.
rentedNoTrue values it as sold with a sitting tenant, False as sold bezugsfrei - in Germany the same flat is worth markedly less with one. Leave it out unless you know which it is.
streetYesStreet and house number, e.g. "Marienplatz 1". Required: without it the answer would silently describe the middle of the postcode.
featuresNoEquipment the property has. Only what it *has* - a feature left out is treated as unknown, not as absent.
postcodeYesFive-digit German postcode, e.g. "80331".
propertyNo"wohnung" (apartment) or "haus" (house).wohnung
year_builtNoYear of construction. Improves the estimate.
property_typeNoA narrower type such as "reihenhaus" or "etagenwohnung"; an unknown value is refused with the list of accepted ones.
living_space_sqmYesLiving area in m².

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior5/5

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

Annotations already declare it a non-destructive, non-open-world read, and the description adds real behavioral depth: the estimate is derived from nearby comparables, `confidence` and `sample_size` encode trustworthiness, the point estimate is omitted when too few comparables back it, and the whole thing is a model output rather than an appraisal. These are failure-mode and reliability details the annotations cannot express.

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

Conciseness4/5

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

Three short paragraphs in a sensible order: what it does, how it sources and qualifies the estimate, then what is returned. Mostly front-loaded and tight, though the final sentence's 'no comparable listing is reproduced in it' is a borderline detail given the output schema already exists.

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

Completeness4/5

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

With an output schema, annotations, and full parameter coverage, the description fills the remaining gap by explaining comparables sourcing, trust signals, and degenerate cases. It is nearly complete; only the relationship to the sibling retrieval tools is left implicit.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all 11 inputs, including the subtle `rented` and `features` semantics. The description adds essentially no input-level meaning beyond that; its explanatory content (confidence, sample_size, point-estimate absence) concerns outputs, which the output schema covers. Baseline 3 applies.

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?

States a specific verb and resource ('Estimate what a German address is worth to buy and to rent'), with explicit scope (Germany, both sale and rental valuation). It is clearly distinguishable from the sibling tools get_listing and search_listings, which retrieve existing listings rather than produce a valuation.

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

Usage Guidelines3/5

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

'Works for any address, listed or not' implies you do not need a listing first, which is useful context against get_listing/search_listings, but the description never names those siblings or states when to prefer them. The only explicit directive is parameter-level ('Leave it out unless you know which it is' for `rented`), so usage is implied rather than spelled out.

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