Quickstart: read the REST API and connect an MCP server
The REST API, the two MCP servers and your own key.
Last updated:
| REST API | Athaus für Anbieter | Athaus Immobiliensuche | |
|---|---|---|---|
| Address | https://api.athaus.ai/v1 | https://anbieter.mcp.athaus.ai/mcp | https://suche.mcp.athaus.ai/mcp |
| For | Systems that read and write an office's listings, contacts and enquiries | Agents working for an office | Agents working for someone searching |
| Sign-in | an ath_live_ key | OAuth 2.1 or an ath_ key | OAuth 2.1 |
| Described in | Reference | Tools | Tools |
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:
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcpclaude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcpFor 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
REST API: the first call
The REST API reads and writes the listings, contacts, inquiries, viewings and files of your office. One key, one call, JSON back.
Example prompts for the MCP servers
Ready-made sentences for Claude and ChatGPT, with the tool Athaus calls for each and the click you make afterwards.
Install the MCP servers: Claude, ChatGPT, Cursor, VS Code
The two Athaus MCP servers in Claude, Claude Code, Cursor, VS Code, ChatGPT and your own agent.
Create an API key and choose its scopes
An API key for the REST API, your own agents and services, with exactly the scopes you give it.