AthausDocs

Quickstart: read the REST API and connect an MCP server

The REST API, the two MCP servers and your own key.

Last updated:

REST APIAthaus für AnbieterAthaus Immobiliensuche
Addresshttps://api.athaus.ai/v1https://anbieter.mcp.athaus.ai/mcphttps://suche.mcp.athaus.ai/mcp
ForSystems that read and write an office's listings, contacts and enquiriesAgents working for an officeAgents working for someone searching
Sign-inan ath_live_ keyOAuth 2.1 or an ath_ keyOAuth 2.1
Described inReferenceToolsTools

Read your office's listings

curl "https://api.athaus.ai/v1/listings?limit=5" \
  -H "Authorization: Bearer ath_live_..."

The response is one page (externalListingIds, nextPageToken, see Pagination). GET /v1/listings/{externalListingId} fetches one listing (Listings). You create the key under Settings, API-Keys, and all routes are in the reference.

Connect an MCP server

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

Athaus für Anbieter
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp
Athaus Immobiliensuche
claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcp

For Claude, ChatGPT, Cursor and VS Code see Installation, plus example prompts and troubleshooting.

Your own agent with a key

Without a browser, create a key under Settings, API-Keys (Pro and Scale plans) and send it as a bearer token. It only works with Athaus für Anbieter:

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

A new key may only read (keys, rights).

These docs for agents

/llms.txt is the table of contents, /llms-full.txt all German pages. Every page is available as Markdown (its address with .md appended). The docs MCP server is at https://docs.athaus.ai/api/mcp, without sign-in.

Keep reading

On this page