Quick start for developers

Athaus has one API and two MCP servers facing outward, built for different readers:

Read the catalogue without signing inCopy Anchor Link

curl "https://api.athaus.ai/api/public/properties?city=Berlin&transaction_type=rent&page_size=5"

The response is one page of results (items, total, page, page_size). GET /api/public/properties/{id} fetches a single listing. All routes, parameters and responses are in the reference. The catalogue only holds properties that providers listed on Athaus themselves.

Connect an MCP serverCopy Anchor Link

With Claude Code it is one line per server; sign-in then happens in the browser:

claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp

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

For Claude, ChatGPT, Cursor and VS Code, see Installation. Which server is for whom is in the overview.

Your own agent with a keyCopy Anchor Link

If you work for an office without a browser, create a key in the app under Settings, API keys and send it as a bearer token. A key only works with Athaus für Makler:

claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
  --header "Authorization: Bearer ath_..."

A new key may only lesen (read). You choose what else it may do when you create it (keys, rights).

These docs for agentsCopy Anchor Link

• /llms.txt is the table of contents, /llms-full.txt all German pages in one file.
• Every page is available as Markdown: its address with .md appended, for example /en/mcp/installation.md, or with Accept: text/markdown.
• The docs have their own MCP server at https://docs.athaus.ai/api/mcp, without sign-in, with the tools list_pages, get_page and search.