# Athaus Immobiliensuche: server and tools

Adresse: https://docs.athaus.ai/en/mcp/werkzeuge/suche

> The MCP server for your own search: connecting it to Claude and ChatGPT, sign-in, limits and all tools, ordered by the right each one requires.

Type: Reference
Last updated: 2026-11-10

The server at `https://suche.mcp.athaus.ai/mcp` only sees your own search, never an office. Its catalogue is the Athaus one: live listings from providers on Athaus, also from our partners. It is best to start with `list_saved_searches` and `list_matches`: what is being searched for and what is new.

## At a glance [#at-a-glance]

|            |                                                                                                                 |
| ---------- | --------------------------------------------------------------------------------------------------------------- |
| For        | People looking for a flat or a house                                                                            |
| Account    | A search account                                                                                                |
| Sign-in    | OAuth 2.1 with your consent; there is no key for this server ([Sign-in](/en/mcp/anmeldung))                     |
| Rights     | `suchen`, `suchauftraege`, `anfragen` ([Rights](/en/mcp/rechte#suche))                                          |
| Interfaces | Listings as a list, exposé, your enquiries, search brief and confirmation card ([Apps and cards](/en/mcp/apps)) |
| Events     | [MCP Events](/en/mcp/ereignisse#suche)                                                                          |
| Limits     | 30 calls at once, then one per second, per account ([Limits](/en/mcp/grenzen#suche))                            |

## What it does [#what-it-does]

* **Search:** search the catalogue, show matching listings as a list, view an exposé and save a listing.
* **Search briefs:** create or change a search brief so Athaus keeps searching, and view and decide on the matches.
* **Enquiries:** enquire at a provider, read enquiries and replies, book or cancel a viewing and release contact details for a provider.
* **Folder:** maintain address, household, financing and documents for your enquiries.
* **Market:** the location of an address from official data, a value range, demand as a number and purchase costs.

An enquiry, a message to a provider and a booking only go out with your click in the card; search has no level that takes over ([Rights](/en/mcp/rechte#klick)).

## Connect [#connect]

- [Add to Claude: Athaus Immobiliensuche](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Athaus%20Immobiliensuche&connectorUrl=https%3A%2F%2Fsuche.mcp.athaus.ai%2Fmcp)

The button opens the custom connector dialog in claude.ai with name and address filled in: **Add**, **Connect**, sign in with your Athaus account and consent. In Claude Code:

```bash
claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcp
```

ChatGPT, Cursor and VS Code are under [Installation](/en/mcp/installation). A token from Athaus für Anbieter opens nothing here, and `anfragen` is off until you switch it on on the consent page.

## The tools [#the-tools]

Ordered by the right each requires, generated from the contract the server reads too. The server itself describes the exact inputs and outputs in `tools/list`.

## Search [#suchen]

Requires the right [`suchen`](/en/mcp/rechte#suchen).

### search\_listings [#search-listings]

**Search listings.** Read only.

Searches the athaus.ai catalogue for listings to buy or rent, by place, type, price limit, rooms and floor area. The catalogue only holds running listings on Athaus that are visible to ChatGPT and Claude, none from other portals.

### show\_listings [#show-listings]

**Show listings.** Read only.

Shows up to eight chosen listings as cards with photo, price, floor area, rooms and place. A click on a card opens the exposé; without a visual interface the same list comes as text.

### get\_listing [#get-listing]

**View the exposé.** Read only.

A listing in full: photos, key facts, description, the mandatory energy certificate details (§ 87 GEG), running costs and deposit for rentals, the commission and the provider with their legal notice. With a visual interface, plus a form for the enquiry.

### list\_inquiries [#list-inquiries]

**My enquiries.** Read only.

Your enquiries about listings, newest first: which property, whether the provider has replied, whether anything is unread, and the latest message.

### get\_inquiry [#get-inquiry]

**View an enquiry.** Read only.

One of your enquiries with its whole history, oldest message first: what you wrote and what the provider replied.

### list\_saved\_searches [#list-saved-searches]

**Search briefs.** Read only.

What Athaus keeps searching for you: place, buy or rent, budget, rooms and must-haves, whether an order is paused and when a new match last came in.

### list\_matches [#list-matches]

**Matches.** Read only.

What your search briefs have found, best first, with price, floor area, rooms, a sentence on why it fits, and the link to the listing. Optionally only the new ones or only those you saved.

## Search briefs [#suchauftraege]

Requires the right [`suchauftraege`](/en/mcp/rechte#suchauftraege).

### favorite\_listing [#favorite-listing]

**Save a listing.** Only changes your own account.

Put a listing on your saved list or take it off again.

### save\_search [#save-search]

**Save a search brief.** Only changes your own account.

Creates a search brief, refines, pauses or resumes it. If a required detail is missing (place, buy or rent, budget, rooms), it creates nothing and asks the next question; a budget is never guessed. Nothing leaves Athaus this way.

### save\_profile [#save-profile]

**Profile.** Only changes your own account.

Address, household, financing and documents for your enquiries.

### delete\_item [#delete-item]

**Delete.** Consequential: waits for your [click](/en/mcp/rechte#klick).

Delete a search brief or a document, only after your click.

## Enquiries [#anfragen]

Requires the right [`anfragen`](/en/mcp/rechte#anfragen).

### send\_inquiry [#send-inquiry]

**Contact the provider.** Consequential: waits for your [click](/en/mcp/rechte#klick).

Prepares an enquiry about a listing to its provider: your name from your Athaus account, your message and, if you want, your phone number. The card shows the sentence about passing on your details; only your click sends the enquiry. For a listing from one of our partners, an Athaus reply address goes along instead of your email address. The provider's reply then appears in your enquiries on Athaus, and you get a copy by email.

### update\_inquiry [#update-inquiry]

**Sort an enquiry.** Only changes your own account.

Archive or restore an enquiry, share your contact details or withdraw that.

### book\_viewing [#book-viewing]

**Book a viewing.** Consequential: waits for your [click](/en/mcp/rechte#klick).

Book an offered slot, with your click.

### cancel\_viewing [#cancel-viewing]

**Cancel a viewing.** Consequential: waits for your [click](/en/mcp/rechte#klick).

Cancel a booked viewing; the provider is told.

### decide\_match [#decide-match]

**Decide on a match.** Only changes your own account.

Keep or drop, also several at once. An enquiry only goes out with your click.

## Market [#markt]

Content that belongs to no account, the same on both servers. Here with the right [`suchen`](/en/mcp/rechte#suchen).

### check\_location [#check-location]

**Check a location.** Read only.

The location of a German address from official and open data, every figure with source and date: standard land value, the 2022 census on a 100 m grid, flood risk, broadband and nearby amenities. With only a postcode, the standard land value and a guide value per square metre of living space. Where a state does not release the land value, the reason is given instead of a number.

### estimate\_value [#estimate-value]

**Estimate a value.** Read only.

A first value range from an address and key facts using the methods of the German ImmoWertV, with the leading method, assumptions and sources. Stores nothing. The result is a market estimate, not a formal valuation under § 194 BauGB.

### count\_demand [#count-demand]

**Count demand.** Read only.

Counts how many active search briefs fit a property and, given a price, how many of them have the budget for it. A number, never a list and never a person; below three it only says that there are fewer than three.

### calculate\_purchase\_costs [#calculate-purchase-costs]

**Purchase costs.** Read only.

Works out the purchase costs: real estate transfer tax by state, notary, land register, the commission if wanted, and the total a buyer really needs.

## The confirmation card [#bestaetigungskarte]

Whatever waits for a click, the server shows as a card in the chat: what will happen, to whom and with which text. Its button calls `confirm_action`. No model sees this tool, only the card calls it, with a token for exactly this one action, and it requires the right [`anfragen`](/en/mcp/rechte#anfragen). Without a visual interface or without this right, you approve in the app.

## Prompts [#prompts]

Two ready-made tasks a client offers as templates:

| Name           | What it does                                                                     |
| -------------- | -------------------------------------------------------------------------------- |
| `find-home`    | Search the athaus.ai catalogue and show the matching listings (argument `what`). |
| `saved-search` | Create or adjust a search brief so Athaus keeps searching.                       |
