Athaus Immobiliensuche: server and tools
The MCP server for your own search: connecting it to Claude and ChatGPT, sign-in, limits and all tools, ordered by the right each one requires.
Last updated:
The server at https://suche.mcp.athaus.ai/mcp only sees your own search, never an office. Its catalogue is the Athaus one: live listings from providers on Athaus, also from our partners. It is best to start with list_saved_searches and list_matches: what is being searched for and what is new.
At a glance
| For | People looking for a flat or a house |
| Account | A search account |
| Sign-in | OAuth 2.1 with your consent; there is no key for this server (Sign-in) |
| Rights | suchen, suchauftraege, anfragen (Rights) |
| Interfaces | Listings as a list, exposé, your enquiries, search brief and confirmation card (Apps and cards) |
| Events | MCP Events |
| Limits | 30 calls at once, then one per second, per account (Limits) |
What it does
- Search: search the catalogue, show matching listings as a list, view an exposé and save a listing.
- Search briefs: create or change a search brief so Athaus keeps searching, and view and decide on the matches.
- Enquiries: enquire at a provider, read enquiries and replies, book or cancel a viewing and release contact details for a provider.
- Folder: maintain address, household, financing and documents for your enquiries.
- Market: the location of an address from official data, a value range, demand as a number and purchase costs.
An enquiry, a message to a provider and a booking only go out with your click in the card; search has no level that takes over (Rights).
Connect
The button opens the custom connector dialog in claude.ai with name and address filled in: Add, Connect, sign in with your Athaus account and consent. In Claude Code:
claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcpChatGPT, Cursor and VS Code are under Installation. A token from Athaus für Anbieter opens nothing here, and anfragen is off until you switch it on on the consent page.
The tools
Ordered by the right each requires, generated from the contract the server reads too. The server itself describes the exact inputs and outputs in tools/list.
Search
Requires the right suchen.
search_listings
Search listings. Read only.
Searches the athaus.ai catalogue for listings to buy or rent, by place, type, price limit, rooms and floor area. The catalogue only holds running listings on Athaus that are visible to ChatGPT and Claude, none from other portals.
show_listings
Show listings. Read only.
Shows up to eight chosen listings as cards with photo, price, floor area, rooms and place. A click on a card opens the exposé; without a visual interface the same list comes as text.
get_listing
View the exposé. Read only.
A listing in full: photos, key facts, description, the mandatory energy certificate details (§ 87 GEG), running costs and deposit for rentals, the commission and the provider with their legal notice. With a visual interface, plus a form for the enquiry.
list_inquiries
My enquiries. Read only.
Your enquiries about listings, newest first: which property, whether the provider has replied, whether anything is unread, and the latest message.
get_inquiry
View an enquiry. Read only.
One of your enquiries with its whole history, oldest message first: what you wrote and what the provider replied.
list_saved_searches
Search briefs. Read only.
What Athaus keeps searching for you: place, buy or rent, budget, rooms and must-haves, whether an order is paused and when a new match last came in.
list_matches
Matches. Read only.
What your search briefs have found, best first, with price, floor area, rooms, a sentence on why it fits, and the link to the listing. Optionally only the new ones or only those you saved.
Search briefs
Requires the right suchauftraege.
favorite_listing
Save a listing. Only changes your own account.
Put a listing on your saved list or take it off again.
save_search
Save a search brief. Only changes your own account.
Creates a search brief, refines, pauses or resumes it. If a required detail is missing (place, buy or rent, budget, rooms), it creates nothing and asks the next question; a budget is never guessed. Nothing leaves Athaus this way.
save_profile
Profile. Only changes your own account.
Address, household, financing and documents for your enquiries.
delete_item
Delete. Consequential: waits for your click.
Delete a search brief or a document, only after your click.
Enquiries
Requires the right anfragen.
send_inquiry
Contact the provider. Consequential: waits for your click.
Prepares an enquiry about a listing to its provider: your name from your Athaus account, your message and, if you want, your phone number. The card shows the sentence about passing on your details; only your click sends the enquiry. For a listing from one of our partners, an Athaus reply address goes along instead of your email address. The provider's reply then appears in your enquiries on Athaus, and you get a copy by email.
update_inquiry
Sort an enquiry. Only changes your own account.
Archive or restore an enquiry, share your contact details or withdraw that.
book_viewing
Book a viewing. Consequential: waits for your click.
Book an offered slot, with your click.
cancel_viewing
Cancel a viewing. Consequential: waits for your click.
Cancel a booked viewing; the provider is told.
decide_match
Decide on a match. Only changes your own account.
Keep or drop, also several at once. An enquiry only goes out with your click.
Market
Content that belongs to no account, the same on both servers. Here with the right suchen.
check_location
Check a location. Read only.
The location of a German address from official and open data, every figure with source and date: standard land value, the 2022 census on a 100 m grid, flood risk, broadband and nearby amenities. With only a postcode, the standard land value and a guide value per square metre of living space. Where a state does not release the land value, the reason is given instead of a number.
estimate_value
Estimate a value. Read only.
A first value range from an address and key facts using the methods of the German ImmoWertV, with the leading method, assumptions and sources. Stores nothing. The result is a market estimate, not a formal valuation under § 194 BauGB.
count_demand
Count demand. Read only.
Counts how many active search briefs fit a property and, given a price, how many of them have the budget for it. A number, never a list and never a person; below three it only says that there are fewer than three.
calculate_purchase_costs
Purchase costs. Read only.
Works out the purchase costs: real estate transfer tax by state, notary, land register, the commission if wanted, and the total a buyer really needs.
The confirmation card
Whatever waits for a click, the server shows as a card in the chat: what will happen, to whom and with which text. Its button calls confirm_action. No model sees this tool, only the card calls it, with a token for exactly this one action, and it requires the right anfragen. Without a visual interface or without this right, you approve in the app.
Prompts
Two ready-made tasks a client offers as templates:
| Name | What it does |
|---|---|
find-home | Search the athaus.ai catalogue and show the matching listings (argument what). |
saved-search | Create or adjust a search brief so Athaus keeps searching. |
Keep reading
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.
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.
MCP rights: what an agent may do
Three rights per server, independent of each other, and the rule for when a click is needed. In OAuth the rights are the scopes, under the same names.