# MCP-Werkzeuge: wie sie gebaut sind

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

> Wie die Werkzeuge der zwei MCP-Server gebaut sind. Die Listen selbst stehen je Server.

Typ: Konzept
Zuletzt aktualisiert: 2026-11-10

Jeder Server hat eine eigene Liste, geordnet nach dem Recht, das ein Werkzeug verlangt.

<Cards>
  <Card title="Athaus für Anbieter" href="/mcp/werkzeuge/anbieter" description="Lagebericht, Bestand, Anfragen, Antworten, Bewertungen, Vorschläge." />

  <Card title="Athaus Immobiliensuche" href="/mcp/werkzeuge/suche" description="Katalog, Exposé, Anfragen an Anbieter, Suchaufträge, Treffer." />
</Cards>

## Die Namen [#die-namen]

Englisch, snake\_case, das Verb vorn; was ein Mensch liest (Titel, Beschreibung, Ergebnis), ist deutsch. `search_` sucht mit Freitext und Filtern, `list_` liest kleine Mengen deines Kontos, `get_` holt ein Ding mit seinem Zusammenhang, `save_` legt ohne Kennung an und ändert mit Kennung, `update_` ändert nur. `draft_`, `send_` und `decide_` können etwas hinausgehen lassen: sie bereiten vor, dein Klick führt aus.

Derselbe Name kann an beiden Servern Verschiedenes heißen: `get_inquiry` ist bei Athaus für Anbieter eine Anfrage an dein Büro, bei der Suche deine Anfrage an ein Inserat. Werte in Eingaben sind englisch (`buy`, `rent`).

## Was ein Werkzeug zurückgibt [#was-ein-werkzeug-zurückgibt]

Eingaben und Rückgaben beschreibt der Server in `tools/list`. Ein Ergebnis hat einen Text, der für sich vollständig ist (zeigt ein Assistent eine Oberfläche, sieht sein Modell nur ihn), dieselben Daten als `structuredContent` und, was auf einen Klick wartet, unter `confirmation`. Ein Fehler kommt als Ergebnis mit `isError`, einem Satz mit dem nächsten Schritt und dem [Fehlercode](/api/fehlercodes) in `_meta["athaus/code"]`; fehlt eine Angabe, stellt es genau eine Frage.

## Hinweise für Modelle [#hinweise-für-modelle]

Der Server liefert die Hinweise des Protokolls mit: `readOnlyHint` bei Werkzeugen, die nur lesen, `destructiveHint`, wo ein Aufruf etwas ersetzt, löscht, verwirft, widerruft oder unwiderruflich schickt (nur Neues anlegen nicht), `openWorldHint`, wo ein Werkzeug fremde Dienste fragt oder selbst etwas hinausgehen lässt. Was hinausgeht, führt der Klick eines Menschen aus ([Rechte](/mcp/rechte#klick)).
