API & Integration

MCP ServerFür Entwickler

Für Entwickler und fortgeschrittene Nutzer — MCP-Server-URL in eigene Clients, Agenten oder Tools integrieren.
Nicht-technisch? Nutze stattdessen In deiner KI nutzen für ChatGPT, Claude, Gemini, Copilot & Co. Diese Seite ist für Entwickler, die eigene Clients oder Agenten bauen.

Überblick

Der MCP-Server sitzt unter https://mcp.bodenrichtwert.ai/mcp und spricht Streamable HTTP mit OAuth-2.0-Authentifizierung. Clients, die den MCP-Standard unterstützen, finden die OAuth-Endpoints automatisch über die Discovery-Dokumente und führen den Token-Flow selbst durch.

Verfügbare Tools

ToolBeschreibung
get_bodenrichtwertBodenrichtwert per Adresse abfragen (optional mit Nutzungsart W / M / G / S / L / F / SO)
calculate_bodenwertBodenrichtwert bei abweichender Geschossflächenzahl (GFZ) umrechnen, optional mit Grundstücksfläche zum Bodenwert (Gesamtwert) — reine Berechnung, zählt nicht gegen dein Kontingent

Deine aktuelle Nutzung und dein Plan-Limit siehst du im Dashboard oder per REST unter GET /api/me.

Claude Desktop (als Referenz-Client)

  1. Claude Desktop → Settings → Developer → Edit Config.
  2. Eintrag ergänzen:
{
  "mcpServers": {
    "bodenrichtwert": {
      "url": "https://mcp.bodenrichtwert.ai/mcp"
    }
  }
}
  1. Claude neu starten. Beim ersten Aufruf öffnet sich der Browser zum OAuth-Login.

Weitere MCP-Clients

Jeder Client, der die MCP-OAuth-Discovery (/.well-known/oauth-protected-resource) unterstützt, kann den Server nutzen. Die Einrichtung ist immer die gleiche: URL https://mcp.bodenrichtwert.ai/mcp eintragen, OAuth-Flow bestätigen, fertig.

ClientEinstellungsort
Perplexity Desktop / MobileSettings → „Connectors" → Custom MCP Server → URL eintragen
CursorSettings → „MCP" → neuen Server mit URL registrieren
WindsurfSettings → „MCP" → MCP Server hinzufügen
Zedmcp.json im Workspace ergänzen, URL eintragen
Eigene Hosts (z. B. claude-code-CLI, mcp-host)Server mit URL registrieren
Lokale Modelle (Ollama mit MCP-Adapter)URL als MCP-Server eintragen

In allen Fällen läuft OAuth über denselben Authority-URL — du meldest dich einmal bei bodenrichtwert.ai an, danach sprechen Client und Server unsichtbar.

Prompt-Beispiele

„Was ist der Bodenrichtwert für Unter den Linden 1, Berlin?"

„Vergleich die Bodenrichtwerte von Alexanderplatz, Potsdamer Platz und Hackescher Markt."

Eigenen MCP-Client bauen

Wenn du einen eigenen MCP-Client implementierst, siehe Einführung für direkt verwendbare Code-Beispiele — in vielen Fällen ist die REST API der einfachere Weg als eine eigene MCP-Implementierung.

Technische Details