Immoprobe

View saved version →

---
name: immoprobe-research
description: Analyse German residential investment listings (Kapitalanlage-Immobilien) with the Immoprobe MCP tools. Map an exposé, a portal page or pasted text to the calculator input, look up the land value (Bodenrichtwert), calculate cashflow, yields and tax effect, write an assessment note with questions for the Makler, and save the object to the user's Immoprobe list; sweep a saved portal search for new listings; review and compare what is saved. Use when the user shares a listing URL, an exposé PDF or text, a portal search, or asks about their saved properties.
---

# Immoprobe research

Immoprobe is the user's system of record for German residential investment
properties and a deterministic calculator. It runs no model of its own: you
read the listing, Immoprobe does the maths, keeps the objects and answers the
geodata from public sources. You work with the `immoprobe` MCP server; if it is not
connected, tell the user how: claude.ai → Settings → Connectors → add
`https://api.immoprobe.de/mcp`; Claude Code →
`claude mcp add --transport http immoprobe https://api.immoprobe.de/mcp`.

## The tools

| Tool | Use it to |
|---|---|
| `get_guide` | the field mapping and how to read every layer — read it once per conversation |
| `calculate_property` | run the calculation for one input; free, but like every tool it needs the user's free account |
| `lookup_address` | find where a listing is and the Bodenrichtwert at the point |
| `save_object` | keep a listing with its input, address, note and lists |
| `find_objects` | list saved objects as compact rows, by status, list, source or text |
| `get_object` | one object in full: input, assumptions, notes, links, attachments, land value |
| `clone_object` | save a copy with other financing or a negotiated price, to compare the variants |
| `add_note` | append a note to a saved object |
| `add_link` | attach a further page of the flat: another portal, the developer, a plan |
| `add_attachments_from_urls` | fetch the listing's photos, Grundriss and a linked PDF into the object by URL |
| `set_object_status` | into the trash (discarded) or back to the list (active) |
| `set_object_lists` | file an object under list names |
| `check_known_listings` | which listing ids are already saved — the sweep cursor |
| `compare_objects` | two to five objects side by side, best value marked |
| `get_account` | who is connected, plan, what is left of the quotas |

Every answer that concerns an object carries a `url` into the web app — show
it. `calculate_property` carries `shareUrl` with charts — show it too.

## Reading a listing

Call `get_guide` once per conversation before the first calculation (or read
`immoprobe://guide`): it carries the field mapping from a listing to the
calculator — Kaufpreis, Wohnfläche, Kaltmiete, Hausgeld, Provision, Baujahr,
the state from the postcode, financing, KfW, a new build's Bauphase, the plot
for the Kaufpreisaufteilung — with units and defaults, and how to read every
layer `lookup_address` answers. The server serves the guide, so it is always
the current contract; this skill is the procedure around it.

Take what the listing states; leave out what it does not. Fields left out
take defaults and come back in `assumed` — show them to the user as
assumptions, never as facts. Pass a stated value even when it equals the
default (a Provision of 3.57 %, say): left out, it would come back as an
assumption although the listing says it. The answer's `summary` lines are the
calculation as facts, a `*` on every assumption: quote them instead of retyping
numbers. Pass `language` (de or en, the user's language) to every tool that
takes it; for any other language pass en and translate yourself. A value you
estimated yourself (a typical Hausgeld, a guessed rent) is an assumption as
well: put its name into `assumed` when you save.

## Locating the listing

Call `lookup_address` before calculating: with `lat` and `lng` when the page
shows the point (I

Preview of the first 4,000 characters. Read full instructions →