list_organizations
Listet alle Organisationen, in denen der Schlüsselinhaber Mitglied ist: ID, Name, Slug, Tarif (plan), deine Rolle (yourRole) und ob die Organisation gerade aktiv ist (isActive). Das Tool funktioniert auch bei kontoweiten Schlüsseln ohne Organisations-Header und ist deshalb der Startpunkt, um Slugs zu ermitteln. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar). Dieses Tool hat keine Parameter.
get_organization
Liefert die aktuelle Organisation: ID, Name, Slug, Tarif, aktivierte Module (enabledModules), Erstellungsdatum und deine Rolle (yourRole). Praktisch, um zu prüfen, welche Modul-Tools in dieser Organisation überhaupt zur Verfügung stehen. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar). Dieses Tool hat keine Parameter.
list_members
Listet die Mitglieder der aktuellen Organisation mit memberId, Rolle, interner Nutzer-ID (userId), Vor- und Nachname, Avatar und supabaseUserId. Die userId brauchst du für Zuweisungen (assigneeId), die supabaseUserId unter anderem für set_member_rate und find_team_free_slots. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).
- limit
- Optional · number — Maximale Anzahl Ergebnisse (Standard 50, höchstens 200).
get_analytics
Ruft Web-Analytics aus der angebundenen PostHog- oder GA4-Integration ab: Seitenaufrufe (gesamt und prozentuale Veränderung zur Vorperiode), eindeutige Besucher, Tagesverlauf, eigene Events (z. B. sign_up oder purchase) sowie – falls vorhanden – Web Vitals, Top-Referrer und Top-Länder (je die ersten fünf). Erfordert eine aktive Analytics-Integration mit hinterlegtem API-Key in der Organisation, sonst kommt ein Fehler. Voraussetzungen: Rolle Viewer oder höher, Schlüssel-Scope „read“ oder höher, kein Modul-Schalter (immer verfügbar).
- range
- Optional · string · -7d | -30d | -90d | -180d | -365d — Zeitraum der Auswertung. Standard: -30d.
- surface
- Optional · string · website | webapp — Beschränkt die Auswertung auf website oder webapp (über die URL-Muster der Analytics-Integration). Ohne Angabe: gesamter Traffic.
Häufige Stolperfallen
Zwei verschiedene Nutzer-IDs
list_members liefert userId (interne ID, z. B. für Zuweisungen von Aufgaben) und supabaseUserId (z. B. für set_member_rate und find_team_free_slots). Verwechsle sie nicht.
list_organizations zeigt alle Mitgliedschaften
Das Tool listet alle Organisationen deines Kontos, auch wenn der Zugang an eine Organisation gebunden ist. Bedienen kannst du nur die gebundene.
Analytics ohne Integration
Ohne aktive Analytics-Integration mit API-Key liefert get_analytics einen Fehler statt leerer Werte.