Athaus für Anbieter: server and tools
The MCP server for your office: 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://anbieter.mcp.athaus.ai/mcp works for your office: what it reads and writes belongs to the organisation you work for. A working day starts best with get_briefing.
At a glance
| For | Brokers and anyone who lists on Athaus |
| Account | A provider account |
| Sign-in | OAuth 2.1 with your consent, or an ath_ key for your own agent (Sign-in) |
| Rights | lesen, vorschlagen, freigeben (Rights) |
| Interfaces | Property and confirmation card (Apps and cards) |
| Events | MCP Events, only for a connection over OAuth |
| Limits | 30 calls at once, then one per second, per account (Limits) |
What it does
- Read: what is on today, the portfolio, enquiries with their messages, viewings, contacts, tasks and valuations.
- Prepare: create or change a property (also from a document or photos), publish or withdraw a listing, draft replies, maintain viewings, contacts, lists, tasks, notes and valuations, share an owner report, set the approvals.
- Approve: accept or discard a suggestion. Whatever goes out is carried out by your click.
- Market: the location of an address from official data, a value range, demand as a number and purchase costs.
Whatever goes out, replaces a value or deletes something waits for your click. When it runs without a click is under 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-makler https://anbieter.mcp.athaus.ai/mcpChatGPT, Cursor, VS Code and your own agents are under Installation. An own agent without a browser signs in with an ath_ key, which exists only for this server; it sees every tool in tools/list, and one without its right says which is missing when called.
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.
Read
Requires the right lesen.
get_briefing
Daily briefing. Read only.
What is due in the office today: unanswered enquiries, suggestions awaiting approval, overdue and current tasks, viewings in the next seven days. Each item comes with the ID to read on.
search_properties
Search your portfolio. Read only.
Finds properties in your own portfolio by address, place or title, for sale or for rent, optionally only those with a live listing. Each comes with key facts, price and the next step.
get_property
View a property. Read only.
A property with everything that matters for the next decision: its details and what is missing, enquiries with their status, open suggestions, the log, viewings, demand as a number and the latest valuation.
search_inquiries
Search enquiries. Read only.
Searches the office's enquiries by stage, property or words such as a name, a message or a street. Each comes with the latest message, financing as a category and whether a draft reply is ready. For enquiries from seekers with a profile also their main details, whether equity is available and whether financing is confirmed.
get_inquiry
View an enquiry. Read only.
An enquiry in full: every message, the qualification, status and stage, a booked viewing, open suggestions with their text and what the agent has noted about the person, each point with the sentence it comes from. For seekers with a profile also their main details, equity available and financing confirmed.
list_proposals
Awaiting approval. Read only.
What waits for a yes, in full, optionally with the levels, balance and log of your automation.
list_viewings
Viewings. Read only.
Viewings in a period with their guests, optionally the free slots.
search_contacts
Search contacts. Read only.
The address book by name, company, email address, place or list.
get_contact
View a contact. Read only.
A contact's file: history, properties, enquiries, notes, tasks, lists and what the agent has noted.
list_tasks
Tasks. Read only.
Open, today's, overdue or completed tasks.
get_valuation
View a valuation. Read only.
A stored valuation with range, leading method, sourced assumptions and demand. Without an ID, the property's most recent one.
Propose
Requires the right vorschlagen.
save_property
Save a property. Only changes your office.
Creates or changes a property: details such as floor area, rooms, year built, energy and prices, the title or the four listing texts. Whatever is missing, Athaus fills in right away, depending on your automation. Anything that would replace an existing value waits as a suggestion for your yes; a price that you or your key state explicitly follows your level for changing prices. With external_id, your own property number, the same call always changes the same property, and two flats at one address stay apart. Files are appended, never replaced, and the same content is not added twice.
publish_listing
Publish a listing. Consequential: waits for your click unless your automation allows otherwise.
Checks the mandatory details, a photo and the legal notice and holds publishing in the catalogue, and in ChatGPT and Claude if wanted, for your click. If your office has set Publish listing to Automatic and the key carries the right freigeben, it goes online without a click. If something is missing, the check also comes as structuredContent.
unpublish_listing
Withdraw a listing. Only changes your office.
Takes a listing off the market at once, or only out of ChatGPT and Claude.
update_inquiry
Sort an enquiry. Only changes your office.
Set the status and stage and confirm noted points. Nothing goes out.
draft_reply
Draft a reply. Consequential: waits for your click unless your automation allows otherwise.
Creates a reply to an enquiry as a suggestion. Without your own text, the Athaus agent writes the draft from the property details; a text you give must pass the check against those details. The reply goes out with your click, or straight away if your office has set replies to Automatic and the connection may approve.
save_viewing
Save a viewing. Only changes your office.
Create, move or cancel viewings and add guests. Anything that notifies guests waits for your click.
save_availability
Availability. Only changes your office.
Weekdays and times when viewings can be booked.
save_contact
Save a contact. Only changes your office.
Create contacts, also from an enquiry, change them, assign lists and merge them. Overwriting and merging wait for your click.
save_list
Save a list. Only changes your office.
Create, rename and pin lists and add or remove entries.
save_task
Save a task. Only changes your office.
Create, change or complete tasks.
save_note
Save a note. Only changes your office.
Keep what matters later, on a person or a property.
save_valuation
Save a valuation. Only changes your office.
Creates a valuation for a property in your portfolio: comparison, income and cost approach under the ImmoWertV from details, documents, location and market reports. Assumptions you name count as the broker's input. The property itself does not change.
share_owner_report
Share the owner report. Only changes your office.
Create a link to the report of a finished valuation, without sending it, or withdraw the link.
update_automation
Set the automation. Consequential: waits for your click unless your automation allows otherwise.
Prepare a level per kind. It is always set with your click.
delete_item
Delete. Consequential: waits for your click unless your automation allows otherwise.
Delete a property, a file, an enquiry, a contact, a list, a task, a note or a valuation, always only after your click.
Approve
Requires the right freigeben.
decide_proposal
Decide on a suggestion. Consequential: waits for your click unless your automation allows otherwise.
Rejects an open suggestion at once, or prepares accepting it: the card then shows what will happen, and only your click carries it out. An accepted reply or rejection is sent to the enquirer.
Market
Content that belongs to no account, the same on both servers. Here with the right lesen.
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 freigeben. Without a visual interface or without this right, you approve in the app.
Prompts
Three ready-made tasks a client offers as templates:
| Name | What it does |
|---|---|
briefing | What is on at the office today, with the next steps. |
answer-inquiry | Read an enquiry and create a reply as a suggestion (argument inquiry_id). |
value-property | Value a property from the portfolio, or an address with key facts (argument what). |
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.