Für KI-Agenten

Navoria Model Context Protocol (MCP)

Navoria stellt einen offenen MCP-Server bereit. KI-Assistenten wie Claude Desktop, Cursor, ChatGPT-Agent oder eigene LLM-Anwendungen können strukturiert nach Ärzt:innen in Deutschland suchen, Fachrichtungs-Empfehlungen einholen und deutsche Notfall-Informationen abrufen – ohne HTML-Scraping.

Endpoint

https://navoria.de/api/mcp

Transport: HTTP + JSON-RPC 2.0
Protokoll-Version: 2025-06-18
Authentifizierung: Keine (Read-only, öffentlich)
Rate-Limit: Fair Use – bei Missbrauch IP-Sperre
Discovery: /.well-known/mcp.json
Anzahl Tools: 7

Quickstart – Tool aufrufen

Beispiel: Zahnärzt:innen in Berlin suchen.

curl -s https://navoria.de/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_doctors",
      "arguments": { "specialty": "Zahnarzt", "city": "Berlin", "limit": 5 }
    }
  }' | jq

Tools auflisten

curl -s https://navoria.de/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

Integration in Claude Desktop

Fügen Sie in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) bzw. dem entsprechenden Pfad unter Windows/Linux ein:

{
  "mcpServers": {
    "navoria": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://navoria.de/api/mcp"]
    }
  }
}

Nach Neustart von Claude Desktop stehen Navoria-Tools zur Verfügung. Nutzen Sie @navoria in einer Konversation.

Verfügbare Tools

search_doctors

↓ Details

Ärzte in Deutschland suchen

Sucht Ärzt:innen und Praxen in Deutschland nach Fachrichtung, Stadt und/oder Postleitzahl. Gibt bis zu 20 Ergebnisse mit Name, Adresse, Fachrichtung, Bewertung und Profil-URL zurück. Nutze dieses Tool, wenn ein Nutzer nach einem Arzt sucht.

Input-Schema

{
  "type": "object",
  "properties": {
    "specialty": {
      "type": "string",
      "description": "Fachrichtung, z. B. \"Hausarzt\", \"Kardiologe\", \"Zahnarzt\", \"Frauenarzt\". Optional, wenn city gesetzt ist."
    },
    "city": {
      "type": "string",
      "description": "Stadt oder Ort, z. B. \"Berlin\", \"München\", \"Hamburg\". Optional."
    },
    "postal_code": {
      "type": "string",
      "description": "Deutsche Postleitzahl, 5-stellig, z. B. \"10115\". Optional."
    },
    "limit": {
      "type": "integer",
      "description": "Maximale Anzahl Treffer (Default 10, max 20).",
      "minimum": 1,
      "maximum": 20
    }
  }
}

get_doctor

↓ Details

Details zu einer Praxis

Liefert vollständige Details zu einer einzelnen Praxis anhand ihrer ID oder ihres Slugs. Enthält Öffnungszeiten, Telefon, Adresse, Fachrichtung und Bewertungen.

Input-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Praxis-ID (UUID). Alternativ zu city_slug + slug."
    },
    "city_slug": {
      "type": "string",
      "description": "City-Slug wie \"berlin\". Nur zusammen mit slug."
    },
    "slug": {
      "type": "string",
      "description": "Praxis-Slug. Nur zusammen mit city_slug."
    }
  }
}

find_specialty_for_symptom

↓ Details

Passende Fachrichtung für Symptom

Schlägt eine oder mehrere passende Fachrichtungen für ein Symptom oder eine Beschwerde vor (z. B. "Rückenschmerzen" → Orthopäde, Hausarzt). Nutze dies vor search_doctors, wenn der Nutzer nur ein Symptom nennt.

Input-Schema

{
  "type": "object",
  "properties": {
    "symptom": {
      "type": "string",
      "description": "Freitext-Beschwerde, z. B. \"Rückenschmerzen\", \"Kopfschmerzen\", \"Hautausschlag\", \"Herzrasen\"."
    }
  },
  "required": [
    "symptom"
  ]
}

list_specialties

↓ Details

Alle Fachrichtungen auflisten

Gibt eine Liste aller auf Navoria unterstützten Fachrichtungen zurück mit Slug, Anzeigename und Übersichts-URL.

Input-Schema

{
  "type": "object",
  "properties": {}
}

list_bundeslaender

↓ Details

Deutsche Bundesländer

Liefert die 16 deutschen Bundesländer mit Hauptstadt und Anzahl gelisteter Praxen.

Input-Schema

{
  "type": "object",
  "properties": {}
}

get_ratgeber

↓ Details

Patienten-Ratgeber-Artikel

Gibt Ratgeber-Artikel zurück (z. B. zu Facharzt-Terminen, Zweitmeinung, Krankenkasse). Ohne Parameter: Liste aller Ratgeber. Mit slug: kompletter Artikel.

Input-Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Ratgeber-Slug wie \"zweitmeinung-einholen\". Optional."
    }
  }
}

get_emergency_info

↓ Details

Notfall-Informationen Deutschland

Gibt strukturierte Informationen zu 112 (Notruf), 116 117 (ärztlicher Bereitschaftsdienst) und wann welche Nummer zu wählen ist.

Input-Schema

{
  "type": "object",
  "properties": {}
}

WebMCP (Browser-Agenten)

Zusätzlich registrieren wir die Tools clientseitig via navigator.modelContext (WebMCP-Draft, Chrome 146+ Canary, allgemeine Verfügbarkeit ab H2/2026). Browser-basierte KI-Agenten sehen die Navoria-Tools automatisch, sobald ein Nutzer navoria.de besucht.

Feature-Detection ist aktiv – auf Browsern ohne WebMCP-Support werden keine Tools registriert (kein Fehler, keine Console-Warnung).

Nutzungsbedingungen

Read-Only: Es werden ausschließlich Lese-Operationen angeboten. Schreibende Aktionen (Korrektur einreichen, Profil beanspruchen) sind bewusst nicht als Tool exponiert.
Attribution empfohlen: Wenn Ihr Agent Navoria-Daten in Antworten verwendet, geben Sie bitte die Quelle an – z. B. „Quelle: navoria.de".
Kein Ärzterating: Sternebewertungen stammen aus Google-Business-Profil und dienen nur der Übersicht, nicht der Bewertung ärztlicher Qualität.
Kein Ersatz für ärztlichen Rat: Empfehlungen aus find_specialty_for_symptom sind keine medizinische Diagnose.
Notfälle: Bei akuten Beschwerden immer 112 wählen. get_emergency_info darf niemals einen tatsächlichen Notruf ersetzen.

Feedback und Kontakt

Sie bauen einen KI-Agenten mit Navoria-Integration? Wir freuen uns über Ihre Rückmeldung – Bugs, Wunsch-Tools, Rate-Limits abstimmen: mail@navoria.de.

Weitere Ressourcen: llms.txt · mcp.json · MCP-Spec