Schnellstart für Entwickler
Die öffentliche API, die zwei MCP-Server und ein eigener Schlüssel.
Athaus hat nach außen eine API und zwei MCP-Server, und sie sind für verschiedene Leser gebaut:
| Öffentliche API | Athaus für Makler | Athaus Immobiliensuche | |
|---|---|---|---|
| Adresse | https://api.athaus.ai/api/public/... | https://anbieter.mcp.athaus.ai/mcp | https://suche.mcp.athaus.ai/mcp |
| Für | Programme, die den Katalog lesen | Agenten, die für ein Büro arbeiten | Agenten, die für einen Suchenden arbeiten |
| Anmeldung | keine | immer: OAuth 2.1 oder ein ath_-Schlüssel | immer: OAuth 2.1 |
| Beschrieben in | OpenAPI 3.1 | tools/list, und hier | tools/list, und hier |
Den Katalog lesen, ohne Anmeldung
curl "https://api.athaus.ai/api/public/properties?city=Berlin&transaction_type=rent&page_size=5"Die Antwort ist eine Seite Treffer (items, total, page, page_size). Ein einzelnes Inserat holt GET /api/public/properties/{id}. Alle Wege, Parameter und Antworten stehen in der Referenz. Der Katalog enthält nur Objekte, die Anbieter selbst bei Athaus eingestellt haben.
Einen MCP-Server verbinden
Mit Claude Code ist es eine Zeile je Server; die Anmeldung läuft danach im Browser:
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcpclaude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcpFür Claude, ChatGPT, Cursor und VS Code steht der Weg unter Installation. Welcher Server für wen ist, steht im Überblick.
Ein eigener Agent mit Schlüssel
Wer ohne Browser für ein Büro arbeitet, legt in der App unter Einstellungen, API-Schlüssel einen Schlüssel an und schickt ihn als Bearer mit. Ein Schlüssel gilt nur bei Athaus für Makler:
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
--header "Authorization: Bearer ath_..."Ein neuer Schlüssel darf nur lesen. Was er sonst darf, wählst du beim Anlegen (Schlüssel, Rechte).
Diese Doku für Agenten
- /llms.txt ist das Inhaltsverzeichnis, /llms-full.txt die ganze deutsche Doku am Stück.
- Jede Seite gibt es als Markdown: ihre Adresse mit
.mddahinter, etwa /mcp/installation.md, oder mitAccept: text/markdown. - Die Doku hat einen eigenen MCP-Server unter
https://docs.athaus.ai/api/mcp, ohne Anmeldung, mit den Werkzeugenlist_pages,get_pageundsearch.