# Athaus Immobiliensuche: Server und Werkzeuge

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

> Der MCP-Server für deine eigene Suche: Verbindung zu Claude und ChatGPT, Anmeldung, Grenzen und alle Werkzeuge, geordnet nach dem Recht, das jedes verlangt.

Typ: Referenz
Zuletzt aktualisiert: 2026-11-10

Der Server unter `https://suche.mcp.athaus.ai/mcp` sieht nur deine eigene Suche, nie ein Büro. Sein Katalog ist der von Athaus: laufende Inserate von Anbietern bei Athaus, auch von unseren Partnern. Am besten beginnst du mit `list_saved_searches` und `list_matches`: wonach gesucht wird und was neu ist.

## Auf einen Blick [#auf-einen-blick]

|             |                                                                                                                |
| ----------- | -------------------------------------------------------------------------------------------------------------- |
| Für wen     | Menschen, die eine Wohnung oder ein Haus suchen                                                                |
| Konto       | Ein Konto der Suche                                                                                            |
| Anmeldung   | OAuth 2.1 mit deiner Zustimmung; einen Schlüssel gibt es für diesen Server nicht ([Anmeldung](/mcp/anmeldung)) |
| Rechte      | `suchen`, `suchauftraege`, `anfragen` ([Rechte](/mcp/rechte#suche))                                            |
| Oberflächen | Inserate als Liste, Exposé, deine Anfragen, Suchauftrag und Bestätigungskarte ([Apps und Karten](/mcp/apps))   |
| Ereignisse  | [MCP Events](/mcp/ereignisse#suche)                                                                            |
| Grenzen     | 30 Aufrufe auf einmal, dann einer je Sekunde, je Konto ([Grenzen](/mcp/grenzen#suche))                         |

## Was er kann [#was-er-kann]

* **Suchen:** im Katalog suchen, die passenden Inserate als Liste zeigen, ein Exposé ansehen und ein Inserat merken.
* **Suchaufträge:** einen Suchauftrag anlegen oder ändern, damit Athaus laufend weitersucht, und die Treffer ansehen und entscheiden.
* **Anfragen:** einen Anbieter anfragen, Anfragen und Antworten lesen, eine Besichtigung buchen oder absagen und Kontaktdaten für einen Anbieter freigeben.
* **Mappe:** Anschrift, Haushalt, Finanzierung und Unterlagen für deine Anfragen pflegen.
* **Markt:** die Lage einer Adresse aus amtlichen Daten, eine Wertspanne, die Nachfrage als Zahl und die Kaufnebenkosten.

Eine Anfrage, eine Nachricht an einen Anbieter und eine Buchung gehen erst mit deinem Klick in der Karte hinaus; bei der Suche gibt es keine Stufe, die das übernimmt ([Rechte](/mcp/rechte#klick)).

## Verbinden [#verbinden]

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

Der Knopf öffnet in claude.ai den Dialog für einen eigenen Connector, Name und Adresse sind ausgefüllt: **Add**, **Connect**, mit deinem Athaus-Konto anmelden und zustimmen. In Claude Code:

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

ChatGPT, Cursor und VS Code stehen unter [Installation](/mcp/installation). Ein Token von Athaus für Anbieter öffnet hier nichts, und `anfragen` ist aus, bis du es auf der Zustimmungsseite einschaltest.

## Die Werkzeuge [#die-werkzeuge]

Geordnet nach dem Recht, das jedes verlangt, aus dem Vertrag erzeugt, aus dem auch der Server liest. Die genauen Eingaben und Rückgaben nennt der Server selbst in `tools/list`.

## Suchen [#suchen]

Braucht das Recht [`suchen`](/mcp/rechte#suchen).

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

**Immobilien suchen.** Liest nur.

Sucht im Katalog von athaus.ai nach Inseraten zum Kauf oder zur Miete, nach Ort, Art, Preisgrenze, Zimmern und Fläche. Der Katalog enthält nur laufende Inserate bei Athaus, die für ChatGPT und Claude sichtbar sind, keine anderer Portale.

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

**Immobilien zeigen.** Liest nur.

Zeigt bis zu acht ausgewählte Inserate als Karten mit Foto, Preis, Fläche, Zimmern und Ort. Ein Klick auf eine Karte öffnet das Exposé; ohne Oberfläche kommt dieselbe Liste als Text.

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

**Exposé ansehen.** Liest nur.

Ein Inserat ganz: Fotos, Eckdaten, Beschreibung, die Pflichtangaben aus dem Energieausweis (§ 87 GEG), bei Miete Nebenkosten und Kaution, die Provision und der Anbieter mit Impressum. Mit Oberfläche dazu ein Formular für die Anfrage.

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

**Meine Anfragen.** Liest nur.

Deine Anfragen an Inserate, die neueste zuerst: zu welchem Objekt, ob der Anbieter geantwortet hat, ob etwas Ungelesenes dabei ist, und die letzte Nachricht.

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

**Anfrage ansehen.** Liest nur.

Eine deiner Anfragen mit ihrem ganzen Verlauf, die älteste Nachricht zuerst: was du geschrieben und was der Anbieter geantwortet hat.

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

**Suchaufträge.** Liest nur.

Wonach Athaus laufend für dich sucht: Ort, Kauf oder Miete, Budget, Zimmer und Muss-Kriterien, ob ein Auftrag pausiert ist und wann zuletzt ein neuer Treffer kam.

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

**Treffer.** Liest nur.

Was deine Suchaufträge gefunden haben, das Beste zuerst, mit Preis, Fläche, Zimmern, einem Satz, warum es passt, und dem Link zum Inserat. Auf Wunsch nur die neuen oder nur die gemerkten.

## Suchaufträge [#suchauftraege]

Braucht das Recht [`suchauftraege`](/mcp/rechte#suchauftraege).

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

**Merken.** Ändert nur dein Konto.

Ein Inserat auf deine Merkliste legen oder wieder herausnehmen.

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

**Suchauftrag speichern.** Ändert nur dein Konto.

Legt einen Suchauftrag an, verfeinert, pausiert oder setzt ihn fort. Fehlt eine Pflichtangabe (Ort, Kauf oder Miete, Budget, Zimmer), legt es nichts an und stellt die nächste Frage; ein Budget wird nie geraten. Hinaus geht dabei nichts.

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

**Mappe.** Ändert nur dein Konto.

Anschrift, Haushalt, Finanzierung und Unterlagen für deine Anfragen.

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

**Löschen.** Folgenreich: wartet auf deinen [Klick](/mcp/rechte#klick).

Einen Suchauftrag oder eine Unterlage löschen, erst nach deinem Klick.

## Anfragen [#anfragen]

Braucht das Recht [`anfragen`](/mcp/rechte#anfragen).

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

**Anbieter anfragen.** Folgenreich: wartet auf deinen [Klick](/mcp/rechte#klick).

Bereitet eine Anfrage zu einem Inserat an seinen Anbieter vor: dein Name aus dem Athaus-Konto, deine Nachricht und auf Wunsch deine Telefonnummer. Die Karte zeigt den Satz zur Weitergabe deiner Angaben; erst dein Klick schickt die Anfrage ab. Bei einem Inserat unserer Partner geht statt deiner E-Mail-Adresse eine Antwortadresse von Athaus mit. Die Antwort des Anbieters steht danach in deinen Anfragen bei Athaus, und du bekommst eine Kopie per E-Mail.

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

**Anfrage ordnen.** Ändert nur dein Konto.

Eine Anfrage archivieren oder zurückholen, deine Kontaktdaten freigeben oder die Freigabe widerrufen.

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

**Besichtigung buchen.** Folgenreich: wartet auf deinen [Klick](/mcp/rechte#klick).

Eine angebotene Zeit buchen, mit deinem Klick.

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

**Besichtigung absagen.** Folgenreich: wartet auf deinen [Klick](/mcp/rechte#klick).

Eine gebuchte Besichtigung absagen; der Anbieter bekommt Bescheid.

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

**Treffer entscheiden.** Ändert nur dein Konto.

Passt oder weg damit, auch für mehrere auf einmal. Eine Anfrage geht erst mit deinem Klick hinaus.

## Markt [#markt]

Inhalte, die keinem Konto gehören, auf beiden Servern dieselben. Hier mit dem Recht [`suchen`](/mcp/rechte#suchen).

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

**Lage prüfen.** Liest nur.

Die Lage einer deutschen Adresse aus amtlichen und offenen Daten, jede Zahl mit Quelle und Stand: Bodenrichtwert, Zensus 2022 im 100-m-Raster, Hochwassergefahr, Breitband und Einrichtungen im Umkreis. Mit nur einer Postleitzahl der Bodenrichtwert und ein Richtwert je Quadratmeter Wohnfläche. Wo ein Land den Bodenrichtwert nicht freigibt, steht der Grund statt einer Zahl.

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

**Wert schätzen.** Liest nur.

Eine erste Wertspanne aus Adresse und Eckdaten nach den Verfahren der ImmoWertV, mit tragendem Verfahren, Annahmen und Fundstellen. Speichert nichts. Das Ergebnis ist eine Marktwerteinschätzung, keine Verkehrswertermittlung nach § 194 BauGB.

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

**Nachfrage zählen.** Liest nur.

Zählt, wie viele aktive Suchaufträge auf ein Objekt passen, und mit Preis, wie viele davon das Budget dafür haben. Eine Zahl, nie eine Liste und nie eine Person; unter drei nur die Auskunft, dass es weniger als drei sind.

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

**Kaufnebenkosten.** Liest nur.

Rechnet die Kaufnebenkosten aus: Grunderwerbsteuer nach Bundesland, Notar, Grundbuch, auf Wunsch die Provision, und die Summe, die ein Käufer wirklich braucht.

## Die Bestätigungskarte [#bestaetigungskarte]

Was auf einen Klick wartet, zeigt der Server als Karte im Chat: was geschieht, an wen und mit welchem Text. Ihr Knopf ruft `confirm_action`. Dieses Werkzeug sieht kein Modell, nur die Karte ruft es, mit einem Token für genau diese eine Handlung, und es verlangt das Recht [`anfragen`](/mcp/rechte#anfragen). Ohne Oberfläche oder ohne dieses Recht gibst du in der App frei.

## Prompts [#prompts]

Zwei fertige Aufträge, die ein Client als Vorlage anbietet:

| Name           | Was er tut                                                                           |
| -------------- | ------------------------------------------------------------------------------------ |
| `find-home`    | Im Katalog von athaus.ai suchen und die passenden Inserate zeigen (Argument `what`). |
| `saved-search` | Einen Suchauftrag anlegen oder anpassen, damit Athaus laufend weitersucht.           |
