Model Context Protocol

Heimster in Ihrem KI-Tool.

Der Heimster-MCP-Server macht Ihre Objekte, Kontakte, Interessenten und Analysen direkt in KI-Assistenten wie Claude, Cursor oder ChatGPT verfügbar. Sie fragen in natürlicher Sprache – das Tool liest und schreibt über Ihre eigene API. Kein Code, kein Schlüssel nötig: Server-Link eintragen, einmal mit Ihrem Heimster-Konto anmelden – fertig.

Server-Adresse
https://heimster-test.xyz/mcp

Transport: HTTP (streamable, zustandslos) · Authentifizierung: Anmeldung mit Heimster-Konto (OAuth) oder Authorization: Bearer …

Einrichtung

Server-Link eintragen, anmelden – fertig.

Für die meisten Tools genügt die Server-Adresse: Beim Verbinden werden Sie zu Heimster geleitet und melden sich einmal mit Ihrem Konto an (OAuth). Ein API-Key ist optional – praktisch für Skripte oder Setups per Konfigurationsdatei.

1

Tool wählen & verbinden

In Claude (Desktop oder claude.ai) fügen Sie Heimster als Custom Connector hinzu – danach läuft die Anmeldung über Ihr Heimster-Konto. Ein API-Key ist optional.

  1. 1 In Claude: «Customize» → «Connectors».
  2. 2 «Add» → «Add custom connector» wählen.
  3. 3 Name «Heimster» und URL «https://heimster-test.xyz/mcp» eintragen, dann hinzufügen.
  4. 4 Verbinden – Claude leitet Sie zu Heimster weiter; melden Sie sich mit Ihrem Konto an (OAuth). Die Werkzeuge greifen dann auf die Organisation dieses Kontos zu.
  5. 5 Danach stehen die Heimster-Werkzeuge direkt im Chat bereit.
Ohne Anmelde-Fenster geht es auch mit einem API-Key: Header «Authorization» = «Bearer <Ihr Key>» hinterlegen. Wer die Desktop-Konfigurationsdatei bearbeitet statt der UI, nutzt die «mcp-remote»-Variante rechts (benötigt Node/npx). Custom Connectors können einen kostenpflichtigen Plan voraussetzen.
Model Context Protocol
claude_desktop_config.json (nur falls über Datei statt UI)
{
  "mcpServers": {
    "heimster": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://heimster-test.xyz/mcp",
        "--header", "Authorization: Bearer hm_DEIN_KEY"
      ]
    }
  }
}

Die genauen Menübezeichnungen ändern sich je nach Tool-Version – Server-URL und Transport (HTTP, streamable) bleiben aber immer gleich.

2

API-Key · optional

Statt sich anzumelden, können Sie einen API-Key als Authorization: Bearer-Header hinterlegen – praktisch für Setups per Konfigurationsdatei (Cursor, VS Code) oder ganz ohne Login. Erstellen Sie einen in den API-Einstellungen und fügen Sie ihn hier ein – die Beispiele oben verwenden ihn dann automatisch.

Wird nur lokal in Ihrem Browser gespeichert.

Werkzeuge

Was Ihr Assistent dann kann.

Fragen Sie in normaler Sprache. Der Assistent kombiniert Ihre Daten, rechnet und rankt auf unserer Seite und antwortet in wenigen Zeilen – statt Rohdaten hin und her zu schieben.

Welche Eigentümer soll ich diese Woche anrufen?
Heimster
6 Eigentümer mit Handlungsbedarf – nach Dringlichkeit: 1. Familie Brunner · verkaufsbereit (konkret) · Wiedervorlage fällig 2. Immo Treuhand AG · Mandat läuft aus (14.09.) 3. Peter Frei · selbstverwaltet vermietet …

Die Reihung kommt aus Ihren Stammdaten – Mandatsablauf, Wiedervorlagen, Verkaufsbereitschaft. Nicht aus einer Schätzung.

Zeig alle Interessenten an der Rietstrasse 43 und bereite den Exposé-Versand an die vor, die es noch nicht haben.
Heimster
7 Interessent:innen ohne Exposé – nach Passung: Auf der Plattform → In-App-Nachricht (4) · Anna Muster · Score 88 · Beat Roth · Score 81 … Kalter CRM-Kontakt → E-Mail (3) · Clara Weber · clara@… Plan zur Freigabe – der Versand erfolgt auf Ihren Klick.

Der Assistent wählt pro Empfänger:in den richtigen Kanal. Gesendet wird nichts ohne Ihre Freigabe.

Wie steht das Bieterverfahren fürs Mehrfamilienhaus?
Heimster
3 aktive Gebote von 2 Bietenden: Verbindlich 1. CHF 4'600'000 (+2.2% vs Anker) 2. CHF 4'350'000 (−3.3%) Abstand Erst-/Zweitplatzierter: CHF 250'000 Noch kein Zuschlag.

Rangfolge, Abstand zum Zweitbieter, Prozent zum Preisanker – serverseitig gerechnet, nicht geschätzt.

Wenn ich den Preis auf 820'000 senke – wen erreicht das?
Heimster
Vorschau: CHF 850'000 → 820'000 (Senkung 3.5%) Reichweite bei Bestätigung: · 12 aktive Bewerber:innen · 34 Merklisten-Follower · + passende Such-Abonnenten Sagen Sie «Ok, senke», um auszulösen.

Erst die Reichweite, dann Ihr ausdrückliches Ja – echte Sendungen laufen nie ungefragt.

Zeig die besten Entwicklungs-Chancen in Zürich.
Heimster
8 Chancen – nach gesicherter Verdichtungsreserve: 1. Erbfall · Dübendorf · 28'300 m² Reserve 2. Baugesuch · Zürich · 5'500 m² Reserve 3. Konkurs · Rüschlikon · 5'400 m² Reserve …

Ereignisse auf unterbauten Parzellen – die anrechenbare Reserve rechnen wir in der Datenbank.

Mach mir das Akquise-Morgenbriefing.
Heimster
Besichtigungen heute (2) · 14:00 · 3.5-Zi Limmatquai · 16:30 · Reihenhaus Uster Fällige Eigentümer-Kontakte (3) · Familie Brunner (verkaufsbereit) … Nachfassen (2) · Mietangebot Weber – seit 5 Tagen offen

Ein gespeicherter Ablauf – ein Wort löst mehrere Werkzeuge aus und verdichtet sie zu einem Briefing.

KI entwirft, Sie senden

E-Mails landen als Outlook-Entwurf, Beiträge als Vorlage – nie automatisch versendet.

Echte Sendungen nur mit Ok

Zweistufig: erst zeigt der Assistent die Reichweite, dann braucht es Ihr ausdrückliches Ja.

Ihre Rechte gelten

Jedes Werkzeug respektiert Rolle und Berechtigungen. Ein Nur-Lese-Zugang kann nichts verändern.

Der volle Umfang

Und alles andere – in Ihrer Sprache.

44 Aufgaben-Werkzeuge, dazu Dossiers zum Anhängen und gespeicherte Abläufe. Sie müssen keine Namen kennen – fragen Sie einfach.

Akquise & Eigentümer

Wen ansprechen, wann, mit welchem Argument – der Farming-Loop.

  • Anrufliste nach Dringlichkeit
  • frische Radar-Signale (Erbfälle, Baugesuche, Konkurse)
  • Entwicklungs-Chancen nach Reserve
  • fertige Ansprache-Argumente zu einem Lead

Objekte & Nachfrage

Wie gefragt ein Objekt ist – und wer dazu passt.

  • anonyme Netzwerk-Nachfrage (nur Zahlen)
  • Engagement: Datenraum, E-Mails, Portale
  • passende CRM-Kontakte finden
  • Schaufenster-Reife prüfen

Bewerbungen & Besichtigungen

Vom Eingang bis zur Entscheidung – ohne dass etwas liegen bleibt.

  • Score-Shortlist je Inserat
  • Entscheidungsstau im Funnel
  • freie Slots mit passenden Kandidaten
  • offene Nachfassfälle

Anlageobjekte

Zahlen, Gebote, Investoren – die schwerste Arithmetik, serverseitig.

  • Rendite & Faktor aus dem Rent-Roll
  • Stand des Bieterverfahrens
  • passende Investoren aus dem CRM
  • Deal-Pipeline & Datenraum-Aktivität

Marketing & Kommunikation

Der Assistent entwirft – gesendet wird auf Ihren Klick.

  • Social-Beiträge & Marketing-Bilder
  • UWG-sichere Mailing-Zielgruppen
  • Antwort-Entwürfe auf Anfragen
  • Eigentümer-Reports

Kalender & Abläufe

Der Überblick – und Routinen in einem Wort.

  • volle Wochenagenda
  • Termine mit Konfliktprüfung
  • gespeicherte Abläufe: Morgenbriefing, Besichtigungswoche, Vermarktungs-Kickoff
Für Entwickler: alle 69 Werkzeuge im Detail

Die Aufgaben-Werkzeuge oben plus granulare Bausteine für alles andere. Jedes respektiert die Rechte Ihres Zugangs – schreibende Aktionen sind markiert, ein Nur-Lese-Zugang kann nichts verändern.

portfolio_status

Which active listings need attention: time online, demand snapshots (searches, profiles, dossiers) and number of applications per listing, with thresholds applied; returns the listings that stand out.

rank_applicants

Lists the applications the agency received for one of its own listings, ordered by the Heimster score (how complete and verified the dossier is and how well it meets the listing's stated requirements), with each application's status. It helps the agent decide which dossiers to review first; it makes no decision and changes nothing – the agent reviews every dossier and decides.

match_object_to_contacts

Ranks the interested parties and buyers registered for an object by Heimster's matching score – who fits best.

daily_overview

A compact daily briefing in one call: today's viewings, the latest applications, acquisition leads under review and how many listings need attention.

review_application_dossier

Checks one application: what is missing, why the score is capped, which documents are present and what to request next. Returns gaps and next steps, not the documents themselves.

portal_push_preview

Dry run of a portal export: shows which listings would be published or withdrawn on which portal right now, without sending anything, and reveals listings that would be skipped (e.g. missing price).

social_post_context

Collects the verified facts for a social-media post about an object (title, price, rooms, number of photos), the connected accounts and recent posts about it. Use the facts verbatim; posting stays manual.

match_inbox_message

Shows inbox messages not yet filed to a record and suggests, per message, the matching object, listing or project from Heimster's matching.

draft_owner_pitch

Writes an AI-generated sales pitch for an object and saves it as a draft. Uses AI credits, so it only runs with confirm=true; without it you get a free preview of what would be created. Nothing is sent or published.

owner_radar

Owners in the organisation's CRM who need attention this week: stated intent to sell, mandates ending within 90 days, due follow-ups and self-managed lettings. Ordered by urgency from the CRM data.

listings_for_contact

Reverse matching: which objects fit a given contact – including pre-market objects not yet public and investment properties – using Heimster's matching score with travel-time correction, and marks where the contact is already in a process.

object_selling_points

The strongest evidence-based arguments for an object, e.g. to win a sales mandate – only signals above documented thresholds (building reserve, neighbourhood scores, sun, solar, taxes, active demand, scarcity in the building register). No generated text and no price estimate.

object_demand

Anonymous demand for an object from the Heimster network: matching search alerts and profiles, strong dossiers, the weekly trend and how many people a pre-market alert could reach. Counts only, never identities.

object_engagement

How engaged the interested parties of an object are: data-room logins and downloads, e-mail opens and clicks, portal sync status, contact requests, reach (page views and conversion) and the top interested parties by interest score (0–100). Flags anomalies such as unused access, portal errors or unanswered enquiries.

listing_quality_check

Which active listings are not yet ready to show: checks each one against a completeness list (enough photos, current translations, tags, location scores, price, description) and lists those with the biggest gaps first.

pending_application_decisions

Where the application funnel is stuck and needs a decision, across all listings: strong applications open for long, shortlisted without a viewing invitation, accepted without an offer, contract sent without signature. Grouped by urgency.

viewings_overview

The organisation's viewing cockpit: upcoming viewings with free places, waiting lists and the public booking link, viewings waiting for the owner's approval, open follow-ups and the last 60 days including visitor feedback. Counts only, no names. Invitations, bookings and sending stay a manual step.

portal_sync_health

Whether all active listings are live on the connected portals or one was rejected: the credential status per portal and the listings whose sync failed, with the error message, errors first.

project_status

Scorecard of a new-build project: units (sale, rent, sold), listings (draft, active), applications, registered interested parties, pre-market registrations and whether a custom domain is active.

calendar_agenda

The full agenda in one call: viewings, handovers, expiring offers, lease ends, investment-property dates and manual appointments – merged and in chronological order for the next days.

open_inbox_enquiries

Which e-mails still need a reply: open threads where the last message came from outside and the team hasn't answered yet, oldest first, with sender, subject, days waiting and the suggested record. Needs the agent's own sign-in (personal mailbox).

follow_up_preview

Who should be followed up because they went quiet: a read-only preview of the automatic follow-ups (open document requests, unanswered rental offers, data-room access granted but never opened), excluding cases already reminded. Sends nothing.

investment_property_metrics

Yield figures of an investment property from its rent roll: target rent per year, gross yield (rent ÷ purchase price), multiplier (purchase price ÷ rent) and the asset class. Yield and multiplier are n/a without an internal price anchor.

bidding_status

Status of the bidding process for an investment property: bids ranked by amount (binding vs. indicative), % against the internal price anchor, gap to the second bid and whether it has been awarded. Display only – does not award.

investment_pipeline

Deal funnel of an investment property (longlist → teaser → interest → NDA → data room → non-binding offer → binding) with stage cohorts and conversion, plus data-room activity and unused or revoked access.

suggest_investors

Which investors in the organisation's CRM fit an investment property: ranks contacts with an investor profile by the fewest deviations (asset class, canton, budget), excluding those already invited, with their consent status.

investment_actions_due

Triage across all investment properties: open data-room requests, unanswered enquiries, NDA signed but no data-room access yet, and undecided bids.

check_mailing_audience

How many recipients a mailing really has: contacts in the segments vs. those that can be e-mailed (e-mail address and marketing consent) vs. those skipped. Counts only.

create_mailing_draft

Creates a mailing as a draft and returns the edit link. It is never sent from here; sending stays a manual step in Heimster.

prepare_expose_dispatch

Prepares sending the exposé of an object: lists the registered interested parties who haven't received it yet, ranked by fit, and suggests the channel per recipient (in-app message or e-mail). Only the plan – sending stays a manual step.

enquiry_reply_facts

The verified facts for replying to an incoming enquiry: the linked listing or object (price, rooms, area, open viewings), whether the sender is a known contact, and for investment properties that prices are only shared under NDA.

queue_social_post_draft

Saves a social-media post about an object as a draft for approval. It is not published; a person approves it in Heimster. Checks that the target account is connected.

render_marketing_image

Renders a marketing image (e.g. a square «just listed» post) from a design template with the object's facts, photos and branding, and returns the image URL for review. Template rendering, no generative AI. Nothing is published.

create_handover_draft

Creates a handover protocol (move-in, move-out or pre-inspection) as a draft, with the rooms of the object and the parties of the current tenancy. Nothing is approved, sent or signed – that happens in the editor. Returns the edit link.

change_price

Two steps. Without a confirmation token it only previews who the change reaches (applicants, saved-listing users, matching search alerts) and whether suppression rules apply; nothing changes and a 5-minute token is returned. With the token the price is set and the notifications go out.

send_premarket_alert

Two steps. Without a confirmation token it previews how many matching subscribers would be notified now; nothing is sent. With the token the pre-market alert e-mails go out (fixed template, one message per object and address, identities stay hidden).

send_owner_report

Two steps. Without a confirmation token it shows the owner, their e-mail and what would be sent; nothing is rendered or sent. With the token the current object report is e-mailed to the owner as a PDF.

schedule_owner_report

Two steps. Without a confirmation token it previews the recipients, cadence and first send date. With the token a recurring owner report is set up (sent automatically later, not now).

create_calendar_event

Two steps. Without a confirmation token it checks for conflicts in the organisation's calendar and shows who would be invited; nothing is created or sent. With the token the event is created and the connected calendar (Outlook or Google) sends real invitations.

list_contacts

Lists the organisation's CRM contacts; search by name, e-mail or company.

create_contact

Creates a CRM contact. If a contact with the same e-mail already exists, the given fields of that contact are overwritten instead. Syncs to HubSpot when connected.

get_contact

One CRM contact with details.

update_contact

Updates the given fields of a CRM contact (overwrites them). Syncs to HubSpot when connected.

list_activities

The timeline of a CRM contact: notes, calls, e-mails, meetings.

create_activity

Adds a note or activity to a CRM contact's timeline.

list_objects

Lists the organisation's properties (objects); search by address or internal reference, filter by status.

get_object

One property (object) with details.

update_object

Updates the given fields of a property (status, price, rooms, area, year built, notes, description). Changes flow into its public listing. The intended use (rent/sale) can't be changed here.

object_interested_parties

The interested parties of a property and their pipeline status.

list_projects

Lists the organisation's new-build projects.

get_project

One new-build project with details.

list_investment_properties

Lists the organisation's investment properties.

get_investment_property

One investment property with details.

list_my_listings

Lists the organisation's own listings; filter by status.

create_listing_draft

Creates a listing as a draft (not public). Publish it later with publish_listing.

get_my_listing

One of the organisation's own listings with details.

update_listing

Updates a listing (title, description, price, rooms, area, address). Setting status to «active» publishes it and setting «inactive» takes it offline – both need two steps: the call without a confirmation token returns a preview and a 5-minute token, the call with the token applies it.

publish_listing

Two steps. Without a confirmation token it previews the go-live (who is alerted, which portals receive it); nothing changes. With the token the draft goes live with its full effects: public listing, portal export, matching search alerts.

deactivate_listing

Takes a listing offline (soft delete: status inactive; the record and its history stay).

list_applications

Lists applications for the organisation's listings; filter by listing or status.

get_application

One application with its dossier (name, verification badges, compatibility, shared documents). The applicant's e-mail is only included when they consented.

update_application_status

Two steps. Shortlists, rejects or waitlists an applicant – the applicant is notified (in-app message and e-mail). Without a confirmation token it previews the notification; with the token the status changes and the notification goes out. Closing steps (acceptance, contract) run in Heimster itself.

update_interested_party

Moves an interested party to another pipeline status and returns the status before and after.

list_viewings

Lists the organisation's viewings, optionally for one day.

create_viewing

Creates a viewing for an object, project or listing (open, series of individual slots, or private). Two steps when it sends e-mails (guest invitations, tenant notice for occupied objects): the call without a confirmation token returns a preview and a 5-minute token, the call with the token creates it. Times are Europe/Zurich; the organisation's approval and tenant-notice rules apply.

list_leads

Lists incoming leads (enquiries not yet handled).

listing_analytics

Views, saves, enquiries and demand snapshots of a listing over time.

create_follow_up

Creates a follow-up task on a contact or object timeline, due at a given time.

draft_outlook_email

Writes an e-mail as a draft into the agent's connected Outlook mailbox (Drafts folder) and never sends it; the agent reviews and sends it from Outlook. Without a connected mailbox the text is returned unsaved.

Ohne Konto

Heimster für Wohnungssuchende – direkt in ChatGPT und Claude.

Eine zweite, öffentliche Adresse ohne Anmeldung: Ihr Assistent findet Inserate, Neubauprojekte, Bauvorhaben und Marktzahlen – und beantwortet Fragen, die nur Heimster-Daten beantworten können: «höchstens 500 m zu Supermarkt und Kita, ruhig, max. 20 Minuten zur Arbeit». Anfragen, Besichtigungen und Suchabos bestätigen Sie per E-Mail.

https://heimster-test.xyz/mcp/public
search_listings

Wohnungen, Häuser, WG-Zimmer, Gewerbe und Parkplätze suchen – auch nach Distanz zu Supermarkt, Kita, Schule und ÖV, Ruhe, Sonne und Arbeitsweg mit dem ÖV.

get_listing

Alle Angaben, Fotos, Grundrisse, Lage und offene Besichtigungen eines Inserats.

compare_listings

Zwei bis vier Inserate nebeneinander.

address_facts

Jede Schweizer Adresse: Gebäude, ÖV, Alltag in der Nähe, Lärm, Marktzahlen und was gebaut wird.

search_new_builds

Neubauprojekte mit freien Einheiten, Preisen ab und Bezugstermin.

upcoming_construction

Was in einer Gemeinde gebaut wird – aus dem eidgenössischen Gebäuderegister (GWR).

area_market_facts

Preise pro m², Mieten und Leerstand einer Gemeinde, eines Kreises oder Quartiers – mit Quelle.

property_value_range

Link zur kostenlosen Eigentümer-Bewertung für eine Adresse (ganze Schweiz; Wert nach SMS-Bestätigung, mit Cockpit).

send_enquiry

Anfrage an den Anbieter eines Inserats – erst nach Bestätigung per E-Mail.

book_viewing

Platz an einer offenen Besichtigung buchen – erst nach Bestätigung per E-Mail.

create_search_alert

Suchabo für neue Inserate – erst nach Bestätigung per E-Mail.

follow_property_value

Wert verfolgen: Link zur Eigentümer-Bewertung – danach monatliches Update im Heimster-Konto.

Keine Anmeldung. Kontaktangaben, Namen privater Vermieter und verborgene Adressen erscheinen nie; geschieht etwas in Ihrem Namen, dann erst nach Ihrem Klick im Bestätigungs-E-Mail. Mehr in der Datenschutzerklärung.

Sicher & unter Ihrer Kontrolle.

Der Server hält keine Daten – er reicht jede Anfrage mit Ihrem Key an Ihre Heimster-API weiter, die Rechte und Organisation prüft. Widerrufen Sie einen Key, verliert jedes damit verbundene Tool sofort den Zugriff.

Keys verwalten