SosoAPI-MCP-Tool-Referenz

Mit der Aufgabe starten, dann das Tool prüfen

Nutze bereits ausgewählte Workspace- und Konto-IDs. Rufe für Bild-URL-Beiträge sosoapi_post_image_url einmal auf und behalte die Beitrags-ID. Lade lokale Dateien mit sosoapi_upload_asset über stdio hoch. Nutze für Text sosoapi_create_scheduled_post mit passendem provider_payload und leerem media.

Bitte vor dem Einreichen um Prüfung von Konto, Text, Medien und Zeitpunkt. OAuth erteilt Handlungszugriff, keine Inhaltsfreigabe. Lies nach dem Planen das Ergebnis desselben Beitrags, bevor du Erfolg meldest oder eine ungewisse Anfrage wiederholst.

• Claude Code oder Codex einrichten
• Threads-Text- und Bildanleitung
• Plattformfunktionsmatrix
• Genaue core-Eingabeschemas und Annotationen herunterladen (JSON)

Diese Referenz verstehen

Der Build verbindet den echten MCP-Server mit einem In-Memory-Client, listet seine Tools ohne Handler-Aufrufe auf und ergänzt öffentliche Routenanforderungen. Eine veraltete Projektion lässt den Landing-Build scheitern. Tool-Beschreibungen behalten den englischen Vertragstext des Servers; Abschlusszusammenfassungen erklären kanonische Routenregeln. Das JSON bewahrt vollständige Routenanforderungen. Die Eingabetabelle ist ein Index, kein Ersatz für das vollständige verschachtelte JSON Schema.

MCP-Annotationen sind Client-Hinweise, keine Durchsetzung oder Sicherheitsgarantien. Workspace-Mitgliedschaft, Berechtigungen, aktuelle Rolle, Anbieterzustimmung, Kontoeignung und Kontingente gelten bei Ausführung weiter. Einige Kontextabfragen können einen ersten Workspace erstellen; prüfe Beschreibung und readOnlyHint, statt jedes „get“ als reinen Lesezugriff anzusehen. Zusammengesetzte Tools listen Anforderungen ihrer Haupt- und Kompatibilitätsrouten; nicht jede Route wird bei jeder Anfrage aufgerufen.

• sosoapi auf npm
• Offizielles MCP Registry: ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_cancel_scheduled_post

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_create_comment

Reihe einen genauen Kommentar zu einem kanonischen Beitrags- oder Kommentarziel ein; der Status bedeutet keinen Anbietererfolg.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:engage. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das plattformbestätigte Ergebnis; eine eingereihte Aktion ist noch ausstehend.

sosoapi_create_scheduled_post

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_get_asset

Lies ein Asset anhand seiner id: Metadaten und eine kurz gültige Vorschau-URL.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_asset_import_status

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_billing_status

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: Kontokontext; keine feste Workspace-Rolle.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_comment_action_status

Lies den bereinigten endgültigen Beleg für eine direkte Kommentaraktion.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:engage. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das plattformbestätigte Ergebnis; eine eingereihte Aktion ist noch ausstehend.

sosoapi_get_organization_context

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: Kontokontext; keine feste Workspace-Rolle.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_provider_insight_status

Lies eine Insight-Anfrage (request_id): queued, processing, completed (mit Anbieterergebnis und Verfügbarkeit je Kennzahl) oder failed.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das Plattformergebnis oder den Grund für seine Nichtverfügbarkeit.

sosoapi_get_scheduled_post

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_scheduled_post_eligibility

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_workspace_context

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: Kontokontext; keine feste Workspace-Rolle.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_get_x_usage

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_import_asset_url

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Ein angenommener Import ist ausstehend; verfolge denselben Import bis ready oder failed.

sosoapi_job_status

Lies einen Hintergrundjob anhand von job_id: Status, Typ und Fehlermeldung bei Fehlschlag.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: Kontokontext; keine feste Workspace-Rolle.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_list_connected_accounts

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: Kontokontext; keine feste Workspace-Rolle.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_list_monitored_posts

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_list_post_comments

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_list_publication_attentions

Liste Veröffentlichungen eines Workspace mit Handlungsbedarf auf, filterbar nach status (open oder resolved) oder scheduled_post_id, mit Offset-Paginierung.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_list_scheduled_posts

Liste geplante Workspace-Beiträge auf, filterbar nach Projekt, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) und Zeitraum, mit Cursor-Paginierung.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_post_image_url

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish + agent:operate. Mindestrollen der Route: editor, viewer.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend. Ein angenommener Import ist ausstehend; verfolge denselben Import bis ready oder failed. Lies die synchrone Antwort.

sosoapi_publish_scheduled_post_now

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_query_assets

Finde Workspace-Assets nach asset_type, source oder tag; liefert eine Seite (limit bis 100, plus offset) und Gesamtzahl. Übergib workspace_id ausdrücklich.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: true. Idempotenz-Hinweis: true. Außenwelt-Hinweis: false.
• Ergebnis prüfen: Lies die synchrone Antwort.

sosoapi_request_provider_insights

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: viewer.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: false. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das Plattformergebnis oder den Grund für seine Nichtverfügbarkeit.

sosoapi_retry_scheduled_post

Wiederhole einen fehlgeschlagenen geplanten Beitrag, optional mit neuem scheduled_at. expected_version erforderlich.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_update_scheduled_post

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.

• Transport: stdio, http.
• Erforderliche Berechtigung: agent:publish. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies das endgültige Veröffentlichungsergebnis; ein angenommener Zeitplan ist noch ausstehend.

sosoapi_upload_asset

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.

• Transport: stdio.
• Erforderliche Berechtigung: agent:operate. Mindestrollen der Route: editor.
• Nur-Lesen-Hinweis: false. Idempotenz-Hinweis: true. Außenwelt-Hinweis: true.
• Ergebnis prüfen: Lies die synchrone Antwort.