MDRealty MCP-Server

Verbindung herstellen

Server-URL

https://mdrealty.me/api/mcp/mcp

Transport: Streamable HTTP. Unterstützt werden Protokollversionen bis 2025-11-25.

Autorisierung

OAuth 2.1 mit dynamischer Client-Registrierung und PKCE. Ihr Client registriert sich selbst, öffnet unsere Zustimmungsseite und Sie klicken auf „Erlauben“ — weder Konto noch Passwort sind nötig. Danach erhält der Client einen eigenen Schlüssel.

Clients

• Claude (Web und Desktop): Öffnen Sie Einstellungen → Konnektoren, fügen Sie einen eigenen Konnektor hinzu und fügen Sie die Server-URL ein.
• ChatGPT: Aktivieren Sie den Entwicklermodus in den Konnektor-Einstellungen, legen Sie einen Konnektor mit der Server-URL an und wählen Sie OAuth.
• Claude Code: Führen Sie den folgenden Befehl im Terminal aus.

  claude mcp add --transport http mdrealty https://mdrealty.me/api/mcp/mcp

• Cursor und andere Clients: Tragen Sie den Server in die MCP-Konfigurationsdatei ein.

  {
    "mcpServers": {
      "mdrealty": {
        "url": "https://mdrealty.me/api/mcp/mcp"
      }
    }
  }

Werkzeuge

Die Liste wird direkt aus dem Server erzeugt und entspricht daher immer dem, was Ihr Client sieht.

Partner- und Mitarbeiterschlüssel schalten zusätzliche Werkzeuge frei, etwa die Suche per Foto und die Prüfung von Duplikaten. Für einen Partnerschlüssel schreiben Sie uns.

JSON-API ohne MCP

Agenten ohne MCP-Unterstützung — GPT Actions, LangChain-Tools, einfache HTTP-Clients — können denselben Katalog über eine JSON-API lesen. Kein Schlüssel und keine Registrierung nötig; die Antworten entsprechen denen der MCP-Tools.

• GET /api/ai/properties — Objektsuche mit denselben Filtern wie search_properties
• GET /api/ai/properties/{slug} — ein Objekt nach Slug, wie get_property
• GET /api/ai/cities — Städte mit Objekten, wie list_cities

Beispiel

curl "https://mdrealty.me/api/ai/properties?citySlug=budva&query=sea%20view&limit=5"

OpenAPI-3.1-Beschreibung/api/ai/openapi.json

Grenzen

• 60 Anfragen pro Minute und Schlüssel. Darüber antwortet der Server mit 429 und dem Header Retry-After.
• Alle öffentlichen Schlüssel einer IP-Adresse teilen sich 300 Anfragen pro Minute.
• Das Verbinden von Clients ist pro IP-Adresse begrenzt: 20 Registrierungen und 20 Token-Anfragen pro Stunde.
• JSON-API ohne Schlüssel: 60 Anfragen pro Minute und IP-Adresse, bis zu 20 Objekte pro Seite (ein größeres limit wird gekürzt), offset höchstens 200.
• Bis zu 20 Objekte pro Seite; für weitere Seiten verwenden Sie offset.
• Preise in Euro. Angebote ändern sich täglich — prüfen Sie die Verfügbarkeit beim Makler, bevor Sie sich auf einen Preis verlassen.

Nutzungsbedingungen

• Nutzen Sie die Daten, um Fragen Ihrer Nutzer zu Immobilien in Montenegro zu beantworten.
• Nennen Sie MDRealty als Quelle und verlinken Sie das Objekt: Zeigen Sie dem Nutzer das Feld url, zitieren Sie canonicalUrl.
• Kopieren Sie den Katalog nicht massenhaft, verkaufen Sie die Daten nicht weiter und bauen Sie damit keine konkurrierende Datenbank auf.
• Die Inhalte dürfen nicht zum Training von KI-Modellen verwendet werden (robots.txt: Content-Signal ai-train=no).
• Wir können missbräuchlich genutzte Schlüssel einschränken oder widerrufen.
• Tool-Aufrufe werden 90 Tage lang protokolliert, um den Dienst zu betreiben und zu schützen: Name des Tools, Parameter mit unkenntlich gemachten E-Mail-Adressen und Telefonnummern sowie eine gekürzte IP-Adresse. Nie genutzte Schlüssel werden nach 30 Tagen gelöscht.

Maschinenlesbare Beschreibung

Agenten können den Server auch ohne diese Seite finden und einrichten:

• MCP-Server-Karte/.well-known/mcp/server-card.json
• OAuth-Metadaten der geschützten Ressource/.well-known/oauth-protected-resource
• Index der Agent-Skills/.well-known/agent-skills/index.json
• llms.txt/llms.txt
• OpenAPI der JSON-API/api/ai/openapi.json

Kontakt

Fragen, ein Partnerschlüssel oder ein fehlendes Werkzeug — schreiben Sie an sales@mdrealty.me.