# MCP-Tool-Referenz

- [MCP-Tool-Referenz](https://sosoapi.ai/de/docs/mcp): Finde Tool-Eingaben, Ausgaben, Profile und lokale oder gehostete Verfügbarkeit.
- [Nutzerprofil abrufen](https://sosoapi.ai/de/docs/mcp/get-user-profile): MCP: Nutzerprofil abrufen. Lies das eigene Profil des angemeldeten Nutzers (Anzeigename, Zeitzone, Avatar, Theme); profile ist null, bis eines existiert.
- [Nutzerprofil aktualisieren](https://sosoapi.ai/de/docs/mcp/update-user-profile): MCP: Nutzerprofil aktualisieren. Ändere das eigene Profil des angemeldeten Nutzers (display_name, timezone, avatar_url, theme). Sende nur zu ändernde Felder.
- [Avatar-Upload signieren](https://sosoapi.ai/de/docs/mcp/sign-avatar-upload): MCP: Avatar-Upload signieren. Rufe eine signierte URL für einen neuen Avatar des angemeldeten Nutzers ab (filename und content_type erforderlich). Ändert das Profil selbst nicht.
- [API-Schlüssel auflisten](https://sosoapi.ai/de/docs/mcp/list-api-keys): MCP: API-Schlüssel auflisten. Liste die API-Schlüssel des Nutzers auf (Name, letzte 4 Zeichen, Status, Ablauf, Herkunft); setze include_authority, um auch Funktionen und Workspace-Grenze jedes Schlüssels zu erhalten. Geheimnisse werden nie zurückgegeben. Erfordert die Berechtigung „API-Schlüssel verwalten“; ein PAT kann dies nicht nutzen.
- [API-Schlüssel erstellen](https://sosoapi.ai/de/docs/mcp/create-api-key): MCP: API-Schlüssel erstellen. Erstelle einen persönlichen Zugriffsschlüssel mit gewählten Funktionen (agent:operate, agent:publish, agent:engage), optionaler workspace_ids-Grenze und bis 365 Tagen Laufzeit; das Geheimnis wird einmal zurückgegeben und ist danach nicht lesbar. Ein Agent kann nur eigene Befugnisse für höchstens 30 Tage weitergeben; endet die Autorisierung, stoppt auch der Schlüssel. Erfordert „API-Schlüssel verwalten“; ein PAT kann dies nicht nutzen.
- [API-Schlüssel verlängern](https://sosoapi.ai/de/docs/mcp/extend-api-key): MCP: API-Schlüssel verlängern. Setze einen späteren Ablaufzeitpunkt (expires_at) für einen API-Schlüssel nach id: höchstens 365 Tage ab jetzt oder 30 für agentenerstellte Schlüssel. Ein Agent darf nur Schlüssel seiner eigenen Autorisierung verlängern. Erfordert „API-Schlüssel verwalten“.
- [API-Schlüssel erneuern](https://sosoapi.ai/de/docs/mcp/renew-api-key): MCP: API-Schlüssel erneuern. Erstelle einen Nachfolger für einen API-Schlüssel (id) mit einmalig zurückgegebenem neuem Geheimnis und denselben Funktionen und Workspace-Grenzen; optional mit neuem Namen oder Laufzeit (höchstens 365 Tage, 30 für agentenerstellte Schlüssel). Der ursprüngliche Schlüssel wird nicht widerrufen. Erfordert „API-Schlüssel verwalten“.
- [API-Schlüssel widerrufen](https://sosoapi.ai/de/docs/mcp/revoke-api-key): MCP: API-Schlüssel widerrufen. Widerrufe einen API-Schlüssel anhand seiner id, sodass er sofort nicht mehr funktioniert; bereits widerrufene Schlüssel melden already_revoked. Ein Agent darf nur Schlüssel seiner eigenen Autorisierung widerrufen. Erfordert „API-Schlüssel verwalten“.
- [Abrechnungsstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-billing-status): MCP: Abrechnungsstatus abrufen. Lies Abrechnungstarif, Zahlungsstatus, aktuelle Zyklusdaten und Kontingentnutzung des Nutzers (erfolgreiche Veröffentlichungen, ausstehende geplante Beiträge, verbundene Konten). Prüfe dies vor großen Planungsdurchläufen.
- [Kommerziellen Zugriff abrufen](https://sosoapi.ai/de/docs/mcp/get-commercial-access): MCP: Kommerziellen Zugriff abrufen. Lies Tarif- und Kontingentfakten zum Abrechnungskonto eines Workspace sowie commercial_access_mode (off, shadow oder enforce).
- [Organisationskontext abrufen](https://sosoapi.ai/de/docs/mcp/get-organization-context): MCP: Organisationskontext abrufen. Lies die aktuelle Übersicht deiner Organisationen, ihrer Workspaces und Kanäle mit IDs und Rollen. Nutze dies bei benötigten Organisations- oder Kanal-IDs. Verwende für Workspace-Beiträge eine zurückgegebene Workspace-ID; lies nicht zusätzlich Workspace-Kontext.
- [Workspace erstellen](https://sosoapi.ai/de/docs/mcp/create-workspace): MCP: Workspace erstellen. Erstelle einen Workspace in einer Organisation, die du besitzt oder verwaltest. Übergib bei mehreren Organisationen organization_id. Nutze die zurückgegebene id für Folgeaufrufe; gehe nicht davon aus, dass der neue Workspace aktiv wird.
- [Workspace-Kontext abrufen](https://sosoapi.ai/de/docs/mcp/get-workspace-context): MCP: Workspace-Kontext abrufen. Liste die Workspaces auf, denen der angemeldete Nutzer angehört, und zeige den aktiven. Nutze dies, wenn workspace_id unbekannt ist; verwende aktuellen Kontext weiter, statt beide Kontextabfragen zu wiederholen. Der gemeldete aktive Workspace ist die Auswahl einer Person in der Web-App, kein Standard für deine Aufrufe: Übergib workspace_id ausdrücklich. Dies ist kein reiner Lesezugriff: Für ein Konto ohne Workspace wird der erste erstellt.
- [Workspace aktualisieren](https://sosoapi.ai/de/docs/mcp/update-workspace): MCP: Workspace aktualisieren. Benenne einen Workspace um oder ändere seinen slug. Nur Workspace-Eigentümer.
- [Organisationen auflisten](https://sosoapi.ai/de/docs/mcp/list-organizations): MCP: Organisationen auflisten. Liste Organisationen des angemeldeten Nutzers mit den IDs auf, die organisationsbezogene Tools als organization_id verwenden.
- [Organisationsverbindungen auflisten](https://sosoapi.ai/de/docs/mcp/list-organization-connections): MCP: Organisationsverbindungen auflisten. Liste Anbieter-Verbindungen (Meta, Instagram, Threads, YouTube) einer Organisation und ihren Status auf. Benötigt organization_id.
- [Organisationsverbindung prüfen](https://sosoapi.ai/de/docs/mcp/review-organization-connection): MCP: Organisationsverbindung prüfen. Lies die von einer ausstehenden Verbindungsoperation (operation_id) ermittelten Anbieterkonten und Seiten zur Prüfung. Nur lesend: Ein Mensch bestätigt die Verbindung in der Web-App.
- [Organisationskanäle auflisten](https://sosoapi.ai/de/docs/mcp/list-organization-channels): MCP: Organisationskanäle auflisten. Liste Organisationskanäle (verbundene Anbieterkonten) und ihren jeweils zugeordneten Workspace auf.
- [Kanalverschiebung vorschauen](https://sosoapi.ai/de/docs/mcp/preview-organization-channel-move): MCP: Kanalverschiebung vorschauen. Probelauf: Prüfe, ob ein Kanal in einen anderen Workspace verschiebbar ist, und liste Hindernisse. Ändert nichts.
- [Workspace-Mitglieder auflisten](https://sosoapi.ai/de/docs/mcp/list-workspace-members): MCP: Workspace-Mitglieder auflisten. Liste Workspace-Mitglieder und ausstehende Einladungen auf.
- [Feedback einreichen](https://sosoapi.ai/de/docs/mcp/submit-feedback): MCP: Feedback einreichen. Sende Produktfeedback (type bug, feature oder general; bis 4,000 Zeichen) im Nutzerauftrag an das SosoAPI-Team. Nur auf Nutzeranfrage verwenden.
- [Benachrichtigungseinstellungen abrufen](https://sosoapi.ai/de/docs/mcp/get-notification-preferences): MCP: Benachrichtigungseinstellungen abrufen. Lies Benachrichtigungseinstellungen des Nutzers (derzeit, ob bei Beitragsfehlern eine E-Mail gesendet wird).
- [Benachrichtigungseinstellungen aktualisieren](https://sosoapi.ai/de/docs/mcp/update-notification-preferences): MCP: Benachrichtigungseinstellungen aktualisieren. Ändere Benachrichtigungseinstellungen des Nutzers (email_post_failed an oder aus).
- [Posteingangsbenachrichtigungen auflisten](https://sosoapi.ai/de/docs/mcp/list-inbox-notifications): MCP: Posteingangsbenachrichtigungen auflisten. Lies den App-Posteingang des Nutzers, neueste zuerst (bis 50), optional nur ungelesene Einträge oder eine Art.
- [Verbundene Konten auflisten](https://sosoapi.ai/de/docs/mcp/list-connected-accounts): MCP: Verbundene Konten auflisten. Liste die mit einem Workspace verbundenen Social-Media-Konten (Instagram, Threads, Facebook, YouTube) mit Verbindungszustand und Funktionsfakten auf. Nutze ihre ids beim Planen oder Kommentieren als social_account_id. Übergib workspace_id: Sobald ausdrückliche Zielangabe erzwungen wird, wird eine Anfrage ohne dieses Feld abgelehnt.
- [Social-Media-Konto trennen](https://sosoapi.ai/de/docs/mcp/disconnect-social-account): MCP: Social-Media-Konto trennen. Trenne ein Konto von seinem Workspace (nur Workspace-Eigentümer). Veröffentlichungen darüber stoppen, bis ein Mensch es erneut verbindet mit `sosoapi connect`.
- [Automatische Social-Media-Kontosynchronisierung festlegen](https://sosoapi.ai/de/docs/mcp/set-social-account-auto-sync): MCP: Automatische Social-Media-Kontosynchronisierung festlegen. Schalte automatische Synchronisierung für ein verbundenes Social-Media-Konto ein oder aus (Rolle editor). Veröffentlicht nichts.
- [Social-Media-Kontosperre aufheben](https://sosoapi.ai/de/docs/mcp/clear-social-account-block): MCP: Social-Media-Kontosperre aufheben. Hebe eine Anbietersperrfrist für ein Konto auf, damit Veröffentlichungen fortgesetzt werden können. Wiederholt keinen fehlgeschlagenen Beitrag; nutze dafür sosoapi_retry_scheduled_post.
- [Assets abfragen](https://sosoapi.ai/de/docs/mcp/query-assets): MCP: Assets abfragen. Finde Workspace-Assets nach asset_type, source oder tag; liefert eine Seite (limit bis 100, plus offset) und Gesamtzahl. Übergib workspace_id ausdrücklich.
- [Asset abrufen](https://sosoapi.ai/de/docs/mcp/get-asset): MCP: Asset abrufen. Lies ein Asset anhand seiner id: Metadaten und eine kurz gültige Vorschau-URL.
- [Asset erstellen](https://sosoapi.ai/de/docs/mcp/create-asset): MCP: Asset erstellen. Registriere ein Asset für bereits gehostete Medien oder Texte (asset_url, asset_type). Lädt nichts hoch: Nutze sosoapi_upload_asset für lokale Dateien oder sosoapi_import_asset_url, damit SosoAPI eine öffentliche URL abruft. Übergib workspace_id (nach erzwungener expliziter Zielangabe ohne dieses abgelehnt). Optionaler idempotency_key.
- [Asset aktualisieren](https://sosoapi.ai/de/docs/mcp/update-asset): MCP: Asset aktualisieren. Ändere Titel, Beschreibung oder Tags eines Assets (Rolle editor).
- [Asset löschen](https://sosoapi.ai/de/docs/mcp/delete-asset): MCP: Asset löschen. Lösche ein Asset anhand seiner id aus der Workspace-Bibliothek. Nur Workspace-Eigentümer.
- [Assets auflisten](https://sosoapi.ai/de/docs/mcp/list-assets): MCP: Assets auflisten. Liste Workspace-Assets gefiltert nach kind (video, image, audio, cover, thumbnail, frame, video-source, branding) oder customer_ready_only mit next_offset-Paginierung auf. workspace_id ist erforderlich.
- [Asset-URL importieren](https://sosoapi.ai/de/docs/mcp/import-asset-url): MCP: Asset-URL importieren. Bitte SosoAPI, eine öffentliche http(s)-Bild- oder Video-URL als neues Asset in privaten Workspace-Speicher herunterzuladen. Liefert import_id; frage sosoapi_get_asset_import_status ab. Benötigt idempotency_key und Rolle editor.
- [Asset-Importstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-asset-import-status): MCP: Asset-Importstatus abrufen. Lies einen Import anhand von import_id. Übergib zum Veröffentlichen include_asset=true: Ein ready-Ergebnis enthält registrierte Asset-id, kind und stabile asset_url und vermeidet ein separates get_asset. Ausstehende oder fehlende Assets lassen sich nicht planen. Nutze niemals Quell- oder Vorschau-URL als Medienidentität. Lies bei Stillstand sosoapi_job_status mit job_id; starte niemals einen doppelten Import.
- [Verwaiste Assets auflisten](https://sosoapi.ai/de/docs/mcp/list-orphan-assets): MCP: Verwaiste Assets auflisten. Liste Speicherobjekte eines Workspace ohne zugehörigen Asset-Datensatz auf (Speicherbereinigung), mit Fortsetzungstoken-Paginierung. Nur Workspace-Eigentümer.
- [Verwaiste Assets löschen](https://sosoapi.ai/de/docs/mcp/delete-orphan-assets): MCP: Verwaiste Assets löschen. Lösche ausgewählte unregistrierte Speicherobjekte anhand ihres Schlüssels. Nur Workspace-Eigentümer; liste sie vorher mit sosoapi_list_orphan_assets auf.
- [Asset-Speicherinventar abrufen](https://sosoapi.ai/de/docs/mcp/get-asset-storage-inventory): MCP: Asset-Speicherinventar abrufen. Lies ein paginiertes Inventar registrierter Assets und gespeicherter Objekte eines Workspace zur Speicherprüfung.
- [Asset-Export erstellen](https://sosoapi.ai/de/docs/mcp/create-asset-export): MCP: Asset-Export erstellen. Exportiere ausgewählte Assets (asset_ids) als Manifest. Der Modus export_verify_then_purge bereitet sie auf spätere Löschung vor. Optionaler idempotency_key.
- [Asset-Export verifizieren](https://sosoapi.ai/de/docs/mcp/verify-asset-export): MCP: Asset-Export verifizieren. Starte die Verifikation eines Asset-Exports (export_id). Vor einer Löschanfrage muss der Export verifiziert sein.
- [Asset-Exportstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-asset-export-status): MCP: Asset-Exportstatus abrufen. Lies den Status eines Asset-Exports: exported, verification_required, verifying, verified oder failed.
- [Asset-Löschung anfordern](https://sosoapi.ai/de/docs/mcp/request-asset-purge): MCP: Asset-Löschung anfordern. Fordere die endgültige Löschung gespeicherter Asset-Bytes an, die ein verifizierter Export abdeckt (export_id, asset_ids; confirm_history_loss kann nötig sein). Nur Workspace-Eigentümer; nach der Löschung unumkehrbar.
- [Asset-Löschung erneut versuchen](https://sosoapi.ai/de/docs/mcp/retry-asset-purge): MCP: Asset-Löschung erneut versuchen. Wiederhole eine gestoppte Löschanfrage (purge_request_id). Nur Workspace-Eigentümer.
- [Projekte auflisten](https://sosoapi.ai/de/docs/mcp/list-projects): MCP: Projekte auflisten. Liste Projekte eines Workspace (optionale Ebene für Herkunft und Kontostandards) und das aktive Projekt auf.
- [Projekt abrufen](https://sosoapi.ai/de/docs/mcp/get-project): MCP: Projekt abrufen. Lies ein Projekt anhand seiner id: Name, Lebenszyklusstatus sowie für spätere Schreibvorgänge nötige Lebenszyklus- und Standardversionen.
- [Projekt erstellen](https://sosoapi.ai/de/docs/mcp/create-project): MCP: Projekt erstellen. Erstelle ein Projekt in einem Workspace. Nur Workspace-Eigentümer; optionaler idempotency_key.
- [Projekt aktualisieren](https://sosoapi.ai/de/docs/mcp/update-project): MCP: Projekt aktualisieren. Benenne ein Projekt um (nur der Name ist bearbeitbar). Nur Workspace-Eigentümer.
- [Aktives Projekt festlegen](https://sosoapi.ai/de/docs/mcp/set-active-project): MCP: Aktives Projekt festlegen. Lege das aktive Projekt des Nutzers fest (serverseitiger Standard).
- [Projekt-Standardkonten abrufen](https://sosoapi.ai/de/docs/mcp/get-project-account-defaults): MCP: Projekt-Standardkonten abrufen. Lies Standard-Social-Media-Konten und kontospezifische Überschreibungen eines Projekts mit defaults_version für das nächste Ersetzen.
- [Projekt-Standardkonten ersetzen](https://sosoapi.ai/de/docs/mcp/replace-project-account-defaults): MCP: Projekt-Standardkonten ersetzen. Ersetze Standardkonten und Überschreibungen eines Projekts in einem Schritt. Benötigt expected_defaults_version aus der letzten Abfrage und idempotency_key (Rolle editor).
- [Projekt archivieren](https://sosoapi.ai/de/docs/mcp/archive-project): MCP: Projekt archivieren. Archiviere ein Projekt, ohne seine Scheduled Posts zu ändern. Um einen Beitrag zu stoppen, brich diesen Scheduled Post separat ab. Nur Workspace-Eigentümer; expected_lifecycle_version und idempotency_key übergeben.
- [Projekt aus dem Archiv holen](https://sosoapi.ai/de/docs/mcp/unarchive-project): MCP: Projekt aus dem Archiv holen. Reaktiviere ein archiviertes Projekt. Beiträge werden dadurch weder fortgesetzt noch neu geplant; verwalte sie über Scheduled Posts. Nur Workspace-Eigentümer; expected_lifecycle_version und idempotency_key übergeben.
- [Projektlebenszyklusverlauf abrufen](https://sosoapi.ai/de/docs/mcp/get-project-lifecycle-history): MCP: Projektlebenszyklusverlauf abrufen. Lies die Lebenszyklusereignisse eines Projekts (etwa Archivierung und Wiederherstellung), bis zu 200.
- [Projektprofil abrufen](https://sosoapi.ai/de/docs/mcp/get-project-profile): MCP: Projektprofil abrufen. Lies das Markenprofil eines Projekts (Slogan, Stimme, Zielgruppe, Ziele, Palette und mehr); ohne Profil ist profile null.
- [Projektprofil aktualisieren](https://sosoapi.ai/de/docs/mcp/update-project-profile): MCP: Projektprofil aktualisieren. Ändere Markenprofilfelder eines Projekts. Ausgelassene Felder bleiben unverändert. Benötigt expected_profile_version aus der letzten Abfrage und idempotency_key (Rolle editor).
- [Projekt-Assets auflisten](https://sosoapi.ai/de/docs/mcp/list-project-assets): MCP: Projekt-Assets auflisten. Liste Projekt-Assets mit Beziehung jeder Verknüpfung (identity, source oder reference) und Cursor-Paginierung auf.
- [Projekt-Asset verknüpfen](https://sosoapi.ai/de/docs/mcp/link-project-asset): MCP: Projekt-Asset verknüpfen. Verknüpfe ein bestehendes Asset mit einem Projekt als identity, source oder reference. Rolle editor; idempotency_key erforderlich.
- [Projekt-Asset-Verknüpfung entfernen](https://sosoapi.ai/de/docs/mcp/unlink-project-asset): MCP: Projekt-Asset-Verknüpfung entfernen. Entferne die Projektverknüpfung eines Assets; das Asset selbst bleibt erhalten. idempotency_key erforderlich.
- [Projektkonten auflisten](https://sosoapi.ai/de/docs/mcp/list-project-accounts): MCP: Projektkonten auflisten. Liste die mit einem Projekt verknüpften Social-Media-Konten mit Cursor-Paginierung auf.
- [Projektkonto verknüpfen](https://sosoapi.ai/de/docs/mcp/link-project-account): MCP: Projektkonto verknüpfen. Verknüpfe ein verbundenes Social-Media-Konto mit einem Projekt. Rolle editor; idempotency_key erforderlich.
- [Projektkonto-Verknüpfung entfernen](https://sosoapi.ai/de/docs/mcp/unlink-project-account): MCP: Projektkonto-Verknüpfung entfernen. Entferne die Projektverknüpfung eines Social-Media-Kontos; das Konto bleibt verbunden. idempotency_key erforderlich.
- [Projektexport erstellen](https://sosoapi.ai/de/docs/mcp/create-project-export): MCP: Projektexport erstellen. Starte einen Projektexport (nur Workspace-Eigentümer); frage sosoapi_get_project_export_status für die Download-URL ab. idempotency_key erforderlich.
- [Projektexportstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-project-export-status): MCP: Projektexportstatus abrufen. Lies einen Projektexport (export_id): queued, processing, completed (mit kurz gültiger Download-URL) oder failed. Nur Workspace-Eigentümer.
- [Veröffentlichungen mit Handlungsbedarf auflisten](https://sosoapi.ai/de/docs/mcp/list-publication-attentions): MCP: Veröffentlichungen mit Handlungsbedarf auflisten. Liste Veröffentlichungen eines Workspace mit Handlungsbedarf auf, filterbar nach status (open oder resolved) oder scheduled_post_id, mit Offset-Paginierung.
- [X-Veröffentlichungscredits abrufen](https://sosoapi.ai/de/docs/mcp/get-x-usage): MCP: X-Veröffentlichungscredits abrufen. Lies die von diesem Workspace geteilten Organisations-X-Credits. Benötigt workspace_id. Free erhält einmal 10, Pro 100 je Abrechnungszeitraum. Text kostet 1, Text mit URL 10. Optionaler text berechnet seine Kosten. Liest gespeicherte Kontingente ohne X-API-Aufruf.
- [Geplante Beiträge auflisten](https://sosoapi.ai/de/docs/mcp/list-scheduled-posts): MCP: Geplante Beiträge auflisten. Liste geplante Workspace-Beiträge auf, filterbar nach Projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) und Zeitraum, mit Cursor-Paginierung.
- [Geplanten Beitrag abrufen](https://sosoapi.ai/de/docs/mcp/get-scheduled-post): MCP: Geplanten Beitrag abrufen. Lies einen geplanten Beitrag anhand seiner id: Inhalt, Status, Zustellungszustand und Ergebnisse. Seine version wird für update, publish, retry und cancel als expected_version benötigt.
- [Eignung geplanter Beiträge abrufen](https://sosoapi.ai/de/docs/mcp/get-scheduled-post-eligibility): MCP: Eignung geplanter Beiträge abrufen. Reine Lesevorprüfung je Ziel. Ergänze draft (caption, hashtags, scheduled_at, display_timezone, optional Ortszeit/DST) für Inhalts-/Zeitprüfungen; include_quota=true ergänzt einen unverbindlichen Zeitraum-Snapshot. Lade/importiere zuerst Medien und warte auf Bereitschaft. Ohne draft werden nur Konto/Medien geprüft. Reserviert nichts; create/dispatch prüfen Grenzen und Befugnisse erneut.
- [Geplanten Beitrag erstellen](https://sosoapi.ai/de/docs/mcp/create-scheduled-post): MCP: Geplanten Beitrag erstellen. Plane für ein Konto zu scheduled_at mit provider_payload. Medien benötigen eine bereite asset_id und kanonische URL; nutze für ein Quellbild sosoapi_post_image_url. Übergib local_scheduled_at und schedule_dst_disambiguation gemeinsam oder lasse beide weg. Erfordert publish, Rolle editor und idempotency_key. Geplant ist nicht veröffentlicht: Lies das Ergebnis.
- [Geplante Beiträge gesammelt erstellen](https://sosoapi.ai/de/docs/mcp/bulk-create-scheduled-posts): MCP: Geplante Beiträge gesammelt erstellen. Plane Beiträge für mehrere Konten in einem Aufruf (targets). Medien benötigen bereite hochgeladene/importierte asset_ids und kanonische URLs. Jedes Ziel gelingt oder scheitert unabhängig und erscheint in successes oder failures. Erfordert publish-Funktion.
- [Geplanten Beitrag aktualisieren](https://sosoapi.ai/de/docs/mcp/update-scheduled-post): MCP: Geplanten Beitrag aktualisieren. Bearbeite einen noch nicht versendeten geplanten Beitrag (caption, hashtags, media, link, time). Benötigt expected_version aus der letzten Abfrage; eine veraltete Version wird abgelehnt.
- [Geplanten Beitrag jetzt veröffentlichen](https://sosoapi.ai/de/docs/mcp/publish-scheduled-post-now): MCP: Geplanten Beitrag jetzt veröffentlichen. Veröffentliche einen geplanten Beitrag sofort statt zu scheduled_at. Öffentlich und nicht rückgängig zu machen; expected_version erforderlich. Eingereiht ist nicht veröffentlicht: Lies das Ergebnis.
- [Geplanten Beitrag erneut versuchen](https://sosoapi.ai/de/docs/mcp/retry-scheduled-post): MCP: Geplanten Beitrag erneut versuchen. Wiederhole einen fehlgeschlagenen geplanten Beitrag, optional mit neuem scheduled_at. expected_version erforderlich.
- [Geplanten Beitrag löschen](https://sosoapi.ai/de/docs/mcp/delete-scheduled-post): MCP: Geplanten Beitrag löschen. Lösche einen nicht veröffentlichten geplanten Beitrag (scheduled, needs_reschedule, failed oder cancelled). Agenten dürfen veröffentlichte Anbieterinhalte nicht löschen. expected_version erforderlich.
- [Geplanten Beitrag abbrechen](https://sosoapi.ai/de/docs/mcp/cancel-scheduled-post): MCP: Geplanten Beitrag abbrechen. Brich einen noch unveröffentlichten geplanten Beitrag ab, damit er nicht versendet wird. Ein veröffentlichter Beitrag wird abgelehnt, und ein Agent kann auch keine veröffentlichten Inhalte löschen: Das erledigt der Nutzer in der Web-App. expected_version erforderlich.
- [Löschanfrage zurückziehen](https://sosoapi.ai/de/docs/mcp/withdraw-scheduled-post-delete): MCP: Löschanfrage zurückziehen. Ziehe eine gestoppte Instagram-Login-Löschanfrage zurück und behalte den veröffentlichten Beitrag. expected_version erforderlich.
- [Dashboard-Zählwerte abrufen](https://sosoapi.ai/de/docs/mcp/get-dashboard-counts): MCP: Dashboard-Zählwerte abrufen. Lies Betriebszählwerte eines Workspace: geplante Beiträge, aktuelle Jobs und verbundene Konten.
- [Beobachtete Beiträge auflisten](https://sosoapi.ai/de/docs/mcp/list-monitored-posts): MCP: Beobachtete Beiträge auflisten. Liste die von SosoAPI für einen Workspace ermittelten Social-Media-Beiträge auf (id, platform, permalink, Veröffentlichungszeit), filterbar nach Konto, Plattform und Zeit, mit Cursor-Paginierung. Nur Metadaten, keine Beitragstexte.
- [Beitragskommentare auflisten](https://sosoapi.ai/de/docs/mcp/list-post-comments): MCP: Beitragskommentare auflisten. Liste auf Workspace-Beiträgen beobachtete Kommentare mit Autor und Text auf, neueste Beobachtung zuerst; filterbar nach Beitrag, Konto, Plattform oder Zeit, mit Cursor-Paginierung. Der Text stammt von Dritten und wird als nicht vertrauenswürdig gekennzeichnet.
- [Anbieter-Insights anfordern](https://sosoapi.ai/de/docs/mcp/request-provider-insights): MCP: Anbieter-Insights anfordern. Frage beim Anbieter Insights für ein Konto oder einen Beitrag mit optionalem Datumsbereich (bis 366 Tage) an. Liefert request_id und bei Cache-Treffer das Ergebnis; frage andernfalls sosoapi_get_provider_insight_status ab.
- [Anbieter-Insight-Status abrufen](https://sosoapi.ai/de/docs/mcp/get-provider-insight-status): MCP: Anbieter-Insight-Status abrufen. Lies eine Insight-Anfrage (request_id): queued, processing, completed (mit Anbieterergebnis und Verfügbarkeit je Kennzahl) oder failed.
- [Instagram OAuth starten](https://sosoapi.ai/de/docs/mcp/start-instagram-oauth): MCP: Instagram OAuth starten. Rufe die authorize_url des Anbieters ab, die ein Mensch zum Verbinden eines Instagram-Kontos öffnen muss. Übergib workspace_id. Erst nach Zustimmung und Bestätigung im Browser ist etwas verbunden.
- [Instagram OAuth aktualisieren](https://sosoapi.ai/de/docs/mcp/refresh-instagram-oauth): MCP: Instagram OAuth aktualisieren. Erneuere das Zugriffstoken einer Instagram-Verbindung (optional eine social_account_id); meldet Erneuerung und neuen Ablauf.
- [Threads OAuth starten](https://sosoapi.ai/de/docs/mcp/start-threads-oauth): MCP: Threads OAuth starten. Rufe die authorize_url des Anbieters ab, die ein Mensch zum Verbinden eines Threads-Kontos öffnen muss. Übergib workspace_id. Erst nach Zustimmung und Bestätigung im Browser ist etwas verbunden.
- [Threads OAuth aktualisieren](https://sosoapi.ai/de/docs/mcp/refresh-threads-oauth): MCP: Threads OAuth aktualisieren. Erneuere das Zugriffstoken einer Threads-Verbindung (optional eine social_account_id); meldet Erneuerung und neuen Ablauf.
- [Threads OAuth prüfen](https://sosoapi.ai/de/docs/mcp/check-threads-oauth): MCP: Threads OAuth prüfen. Lies den Zustand der Threads-Verbindung: connected, expiry, scope und Erneuerbarkeit. Übergib workspace_id.
- [Meta OAuth starten](https://sosoapi.ai/de/docs/mcp/start-meta-oauth): MCP: Meta OAuth starten. Rufe die authorize_url des Anbieters ab, die ein Mensch zum Verbinden einer Facebook-Seite oder Instagram über Facebook (connection_intent) öffnen muss. Übergib workspace_id. Erst nach Zustimmung und Bestätigung im Browser ist etwas verbunden.
- [Meta OAuth aktualisieren](https://sosoapi.ai/de/docs/mcp/refresh-meta-oauth): MCP: Meta OAuth aktualisieren. Verifiziere eine Facebook-/Meta-Verbindung (social_account_id) erneut und melde capability_verified.
- [YouTube OAuth starten](https://sosoapi.ai/de/docs/mcp/start-youtube-oauth): MCP: YouTube OAuth starten. Rufe die authorize_url des Anbieters ab, die ein Mensch zum Verbinden eines YouTube-Kanals öffnen muss. Übergib workspace_id. Erst nach Zustimmung und Bestätigung im Browser ist etwas verbunden.
- [YouTube OAuth aktualisieren](https://sosoapi.ai/de/docs/mcp/refresh-youtube-oauth): MCP: YouTube OAuth aktualisieren. Erneuere das Token einer YouTube-Verbindung (social_account_id); liefert neuen Ablauf und capability_verified.
- [Jobs auflisten](https://sosoapi.ai/de/docs/mcp/list-jobs): MCP: Jobs auflisten. Liste aktuelle Hintergrundjobs des angemeldeten Nutzers mit Status und Fortschritt auf.
- [Jobstatus abrufen](https://sosoapi.ai/de/docs/mcp/job-status): MCP: Jobstatus abrufen. Lies einen Hintergrundjob anhand von job_id: Status, Typ und Fehlermeldung bei Fehlschlag.
- [Kommentar-Zustellungsergebnis abrufen](https://sosoapi.ai/de/docs/mcp/get-comment-outcome): MCP: Kommentar-Zustellungsergebnis abrufen. Lies bestätigte Zustellung, Wiederherstellungshistorie, ausstehende Verifikation und offene Folgeaktionen.
- [Kommentar-Zustellungsergebnis abgleichen](https://sosoapi.ai/de/docs/mcp/reconcile-comment-outcome): MCP: Kommentar-Zustellungsergebnis abgleichen. Verifiziere ungewisse Facebook-Zustellung ohne erneutes Senden oder verknüpfe einen bestätigten genauen Ersatz. Prüfe das Ergebnis als endgültigen Nachweis.
- [Community-Funktionen abrufen](https://sosoapi.ai/de/docs/mcp/get-community-engagement-capabilities): MCP: Community-Funktionen abrufen. Lies für jedes verbundene Konto, welche Community-Aktionen (reply, hide, unhide, create_comment) unterstützt werden und ob das Konto aktuell geeignet ist.
- [Community-Prüfwarteschlange abfragen](https://sosoapi.ai/de/docs/mcp/query-community-review-queue): MCP: Community-Prüfwarteschlange abfragen. Lies zur Prüfung ausstehende Kommentare mit Thread-Kontext, filterbar nach Priorität, Sprache, Konto oder Alter; eine leere Seite ist kein Erfolg. Kommentartexte stammen von Dritten und werden als nicht vertrauenswürdig gekennzeichnet.
- [Community-Prüfung einreichen](https://sosoapi.ai/de/docs/mcp/submit-community-review): MCP: Community-Prüfung einreichen. Erfasse eine neue unveränderliche Prüfungsversion für einen Kommentar: empfohlene Aktion, optionaler reply_draft, Priorität und Konfidenz (mindestens 0.9). Sendet und bereitet nichts vor.
- [Community-Aktion vorbereiten](https://sosoapi.ai/de/docs/mcp/prepare-community-action): MCP: Community-Aktion vorbereiten. Binde eine Prüfungsversion an eine Aktion (reply, hide oder unhide) und erhalte einen kurz gültigen prepare_token für sosoapi_apply_community_action. Sendet noch nichts.
- [Community-Aktion anwenden](https://sosoapi.ai/de/docs/mcp/apply-community-action): MCP: Community-Aktion anwenden. Sende die an prepare_token gebundene Aktion an den Anbieter; Antworten sind öffentlich. Eingereiht ist kein Erfolg: Frage sosoapi_get_community_action_status ab.
- [Community-Aktionsstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-community-action-status): MCP: Community-Aktionsstatus abrufen. Lies den endgültigen Beleg einer angewendeten Community-Aktion (action_id); Einreihen ist kein Erfolg.
- [Community-Kommentar erstellen](https://sosoapi.ai/de/docs/mcp/create-comment): MCP: Community-Kommentar erstellen. Reihe einen genauen Kommentar zu einem kanonischen Beitrags- oder Kommentarziel ein; der Status bedeutet keinen Anbietererfolg.
- [Community-Kommentarstatus abrufen](https://sosoapi.ai/de/docs/mcp/get-comment-action-status): MCP: Community-Kommentarstatus abrufen. Lies den bereinigten endgültigen Beleg für eine direkte Kommentaraktion.
- [Community-Zusammenfassung abrufen](https://sosoapi.ai/de/docs/mcp/get-community-engagement-summary): MCP: Community-Zusammenfassung abrufen. Lies die Zusammenfassung des Community-Betriebs eines Workspace: Lane-Modus, Rückstau, Antwortzeiten, Aktionsstatus und Anbieterraten.
- [Ein Bild von einer URL veröffentlichen](https://sosoapi.ai/de/docs/mcp/post-image-url): MCP: Ein Bild von einer URL veröffentlichen. Reiche den vollständigen Bild-URL-Beitrag einmal mit leerem media ein. Das Backend bereitet ihn auch nach Verbindungsabbruch vor und veröffentlicht ihn. Liefert binnen 35 Sekunden das endgültige Veröffentlichungsergebnis, falls verfügbar, sonst eine dauerhafte Beitrags-ID; niemals mit neuem Schlüssel erneut einreichen. Erfordert operate- und publish-Berechtigungen. Ortszeit-/DST-Felder gehören zusammen. import_id dient nur der Wiederaufnahme älterer Clients.
- [Lokales Bild oder Video hochladen](https://sosoapi.ai/de/docs/mcp/upload-asset): MCP: Lokales Bild oder Video hochladen. Lade eine lokale Bild- oder Videodatei in die Asset-Bibliothek eines Workspace und registriere sie als Asset. Akzeptiert werden nur echte PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG-Dateien bis 500 MiB aus Arbeitsverzeichnis, temporärem Ordner, Pictures/Movies/Videos oder SOSOAPI_UPLOAD_ROOTS; Punktdateien und Punktordner werden abgelehnt. Liefert Asset-id und URL für Scheduled-Post-Medien.