MCP-Tools — Übersicht

Zugriffsrechte

MCP-Tools werden drei Scope-Leveln zugeordnet:

Scope	Bedeutung
`read`	Nur lesender Zugriff; kein Anlegen, Bearbeiten oder Löschen
`write`	Lesen und Schreiben von Quellen, Kanälen, Inbox; kein Zugriff auf Team-Einstellungen
`admin`	Voller MCP-Zugriff inklusive Team-Einstellungen

Bei OAuth-Verbindungen begrenzt der beim Autorisieren gewählte Scope, welche Tools aufrufbar sind. Bei API-Tokens bestimmt die Token-Rolle das Zugriffsmaximum.

Read-Tools

Alle Read-Tools erfordern mindestens Scope read.

`search_updates`

Durchsucht Updates nach Suchbegriffen, Quellen, Tags und Zeitraum.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`query`	String	Volltext-Suchbegriff (optional)
`source_id`	String	Updates einer bestimmten Quelle (optional)
`tags`	Array	Update-Tags, nach denen gefiltert wird (optional)
`folder`	String	`inbox`, `saved` oder `dropped` (optional)
`source_ownership`	String	`all` (Standard), `own` (nur eigene Quellen) oder `competitor` (nur fremde Quellen)
`limit`	Integer	Anzahl der Ergebnisse (Standard: 20, max: 100)

Der Filter source_ownership nutzt das Feld is_own an der Quelle. Er ist das Gegenstück zum Ownership-Filter in der Inbox-UI und erlaubt dem KI-Assistenten, gezielt nur eigene Präsenz oder nur Wettbewerber zu betrachten.

`get_update_details`

Gibt den vollständigen Inhalt eines einzelnen Updates zurück.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`update_id`	String	ID des Updates

`list_sources`

Listet alle Quellen des Workspace.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`is_own`	Boolean	`true` = nur eigene Quellen, `false` = nur Wettbewerber, weglassen = alle

Jede zurückgegebene Quelle enthält das Feld is_own, damit KI-Assistenten eigene Präsenz und Wettbewerber trennen können, ohne eine zweite Anfrage stellen zu müssen.

`list_reports`

Listet verfügbare KI-Berichte.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`type`	String	`summary`, `feedback`, `list`, `linkedin_post`, `conversation_starters` (optional)
`limit`	Integer	Anzahl (Standard: 10)

`get_report`

Gibt den vollständigen Inhalt eines Berichts zurück.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`report_id`	String	ID des Berichts

`get_team_context`

Gibt den KI-Kontext des Workspace zurück: Team-Metadaten (Name, Sprache, Zeitzone), Website-URL, Kontext-Dokumente und die Ownership-Konfiguration.

Erforderlicher Scope: read

Keine Pflicht-Parameter.

Antwort enthält im context-Block:

website_url – hinterlegte Organisations-URL
is_own_sources_configured – true, sobald mindestens eine Quelle als eigene markiert ist
own_sources_count – Anzahl eigener Quellen

KI-Assistenten sollen Voice-Share- oder Momentum-Vergleiche nur dann anbieten, wenn is_own_sources_configured true ist — sonst fehlt die Vergleichsbasis.

`list_tags`

Listet alle Tags des Workspace.

Erforderlicher Scope: read

Parameter	Typ	Beschreibung
`type`	String	`sources`, `channels`, `updates` (optional)