Naslag voor SosoAPI MCP-tools

Begin met de taak en bekijk daarna de tool

Hergebruik de al gekozen werkruimte- en account-IDs. Roep voor een bericht met afbeeldings-URL sosoapi_post_image_url één keer aan en bewaar de bericht-ID. Upload lokale bestanden met sosoapi_upload_asset via stdio. Gebruik voor tekst sosoapi_create_scheduled_post met de provider_payload van de bestemming en lege media.

Vraag de gebruiker vóór indiening account, tekst, media en tijdstip te beoordelen. OAuth verleent toegang om acties uit te voeren; het keurt inhoud niet goed. Lees na het inplannen het publicatieresultaat van hetzelfde bericht voordat je succes meldt of een verzoek met onzeker resultaat opnieuw probeert.

• Configureer Claude Code of Codex
• Threads-stappen voor tekst en afbeeldingen
• Matrix van platformmogelijkheden
• Download exacte core-invoerschema's en annotaties (JSON)

Zo lees je dit naslagwerk

De build verbindt de echte MCP-server met een client in het geheugen, toont de tools zonder handlers aan te roepen en voegt openbare routevereisten samen. Een verouderde projectie laat de Landing-build mislukken. Toolbeschrijvingen behouden de Engelse contracttekst van de server; voltooiingssamenvattingen leggen canonieke routeregels uit. De JSON behoudt volledige routevereisten. De invoertabel is een index en vervangt het volledige geneste JSON Schema niet.

MCP-annotaties zijn aanwijzingen voor clients, geen afdwinging of veiligheidsgarantie. Werkruimtelidmaatschap, machtigingen, huidige rol, providertoestemming, accountgeschiktheid en quota blijven bij uitvoering gelden. Sommige contextleesacties maken een eerste werkruimte; bekijk beschrijving en readOnlyHint in plaats van aan te nemen dat elke ‘get’ uitsluitend leest. Samengestelde tools tonen vereisten voor hoofd- en compatibiliteitsroutes; ze roepen niet bij elk verzoek elke vermelde route aan.

• sosoapi op npm
• Officieel MCP-register: ai.sosoapi/sosoapi (JSON)

sosoapi_bulk_create_scheduled_posts

Plan met één aanroep berichten in voor meerdere accounts (targets). Media vereisen gereedstaande geüploade/geïmporteerde asset_ids en hun canonieke URLs. Elke bestemming slaagt of mislukt afzonderlijk en wordt vermeld in successes of failures. Vereist de bevoegdheid publish.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_cancel_scheduled_post

Annuleer een nog niet gepubliceerd ingepland bericht zodat het niet wordt verzonden. Een gepubliceerd bericht wordt geweigerd; een agent kan gepubliceerde inhoud ook niet verwijderen: dat doet de gebruiker in de webapp. Vereist expected_version.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_create_comment

Zet één exacte reactie op een canoniek bericht of een canonieke reactie in de wachtrij; de status bewijst geen succes bij de provider.

• Transport: stdio, http.
• Vereiste machtiging: agent:engage. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het platformbevestigde resultaat; een actie in de wachtrij is nog in behandeling.

sosoapi_create_scheduled_post

Plan voor één account een bericht in op scheduled_at met provider_payload. Media vereisen een gereedstaande asset_id en canonieke URL; gebruik voor één bronafbeelding sosoapi_post_image_url. Geef local_scheduled_at samen met schedule_dst_disambiguation mee of laat beide weg. Vereist publish, de rol editor en idempotency_key. Ingepland betekent niet gepubliceerd: lees het resultaat.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_get_asset

Lees één mediabestand op id: metadata en een kort geldige voorbeeld-URL.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_asset_import_status

Lees een import op import_id. Geef voor publicatie include_asset=true mee: een gereed resultaat bevat de geregistreerde media-id, het type en de stabiele asset_url, zodat een aparte get_asset niet nodig is. Wachtende of ontbrekende mediabestanden kunnen niet worden ingepland. Gebruik nooit de bron- of voorbeeld-URL als media-identiteit. Vraag bij stilstand sosoapi_job_status op met job_id; start nooit een dubbele import.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_billing_status

Lees het abonnement, de betaalstatus, de datums van de huidige cyclus en het quotagebruik van de gebruiker (geslaagde publicaties, wachtende ingeplande berichten, verbonden accounts). Controleer dit voordat je veel berichten inplant.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: accountcontext; geen vaste werkruimterol.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_comment_action_status

Lees het opgeschoonde definitieve resultaatbewijs van een directe reactieactie.

• Transport: stdio, http.
• Vereiste machtiging: agent:engage. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het platformbevestigde resultaat; een actie in de wachtrij is nog in behandeling.

sosoapi_get_organization_context

Lees het actuele overzicht van je organisaties, hun werkruimten en kanalen met ids en rollen. Gebruik dit wanneer organisatie- of kanaal-ids nodig zijn. Hergebruik voor publicatie in een werkruimte een teruggegeven werkruimte-id; vraag niet ook de werkruimtecontext op.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: accountcontext; geen vaste werkruimterol.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_provider_insight_status

Lees een statistiekaanvraag (request_id): queued, processing, completed (met het providerresultaat en beschikbaarheid per meetwaarde) of failed.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het platformresultaat of de reden waarom het niet beschikbaar is.

sosoapi_get_scheduled_post

Lees één ingepland bericht op id: inhoud, status, afleverstatus en resultaten. De versie ervan is nodig als expected_version voor bijwerken, publiceren, opnieuw proberen en annuleren.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_scheduled_post_eligibility

Voorafgaande leescontrole per bestemming. Voeg draft toe (caption, hashtags, scheduled_at, display_timezone, optionele lokale tijd/zomertijd) voor controle van inhoud en tijdstip; include_quota=true voegt een adviserend overzicht van de periode toe. Upload/importeer media en wacht eerst tot ze gereed zijn. Zonder draft worden alleen account en media gecontroleerd. Reserveert niets; bij aanmaken en uitvoeren worden limieten en bevoegdheden opnieuw gecontroleerd.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_workspace_context

Toon de werkruimten waarvan de aangemelde gebruiker lid is en welke actief is. Gebruik dit als workspace_id onbekend is; hergebruik actuele context in plaats van beide contextaanvragen te herhalen. De gemelde actieve werkruimte is de keuze van een persoon in de webapp en geen standaard voor je aanroepen: geef workspace_id expliciet mee. Dit is niet uitsluitend een leesactie: voor een account zonder werkruimte wordt de eerste gemaakt.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: accountcontext; geen vaste werkruimterol.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_get_x_usage

Lees de X-publicatiecredits van de organisatie die deze werkruimte deelt. Vereist workspace_id. Free krijgt eenmalig 10; Pro krijgt 100 per factureringsperiode. Tekst kost 1, tekst met een URL kost 10. Optionele text toont de kosten ervan. Dit leest de opgeslagen toelage en roept geen X API aan.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_import_asset_url

Vraag SosoAPI een afbeelding of video van een openbare http(s)-URL als nieuw mediabestand naar de privéopslag van de werkruimte te downloaden. Geeft een import_id terug; vraag de status op via sosoapi_get_asset_import_status. Vereist een idempotency_key en de rol editor.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: een geaccepteerde import is nog in behandeling; volg dezelfde import tot ready of failed.

sosoapi_job_status

Lees één achtergrondtaak op job_id: status, type en de foutmelding als deze is mislukt.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: accountcontext; geen vaste werkruimterol.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_list_connected_accounts

Toon de socialmedia-accounts (Instagram, Threads, Facebook, YouTube) die met een werkruimte zijn verbonden, met verbindingsgezondheid en vastgestelde mogelijkheden. Gebruik hun ids als social_account_id bij inplannen of reageren. Geef workspace_id mee: een verzoek zonder dit veld wordt geweigerd zodra expliciete selectie wordt afgedwongen.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: accountcontext; geen vaste werkruimterol.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_list_monitored_posts

Toon de socialmediaberichten die SosoAPI voor een werkruimte heeft gevonden (id, platform, permalink, publicatietijd), met filters voor account, platform en tijd en cursorpaginering. Alleen metadata, geen bijschriften.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_list_post_comments

Toon waargenomen reacties op werkruimteberichten, nieuwste waarneming eerst, met auteur en tekst; filter op bericht, account, platform of tijd, met cursorpaginering. De tekst is door derden geschreven en gemarkeerd als niet-vertrouwd.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_list_publication_attentions

Toon werkruimtepublicaties die aandacht vereisen, gefilterd op status (open of resolved) of scheduled_post_id, gepagineerd met offset.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_list_scheduled_posts

Toon de ingeplande berichten van een werkruimte, met filters voor project, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) en tijdsbereik, met cursorpaginering.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_post_image_url

Dien het volledige bericht met afbeeldings-URL één keer in, met lege media. De backend bereidt het voor en publiceert het ook nadat de clientverbinding is verbroken. Geeft het definitieve publicatieresultaat terug als dit binnen 35 seconden beschikbaar is, anders een blijvende bericht-ID; dien het nooit opnieuw in met een nieuwe sleutel. Vereist de machtigingen operate en publish. Velden voor lokale tijd en zomertijd horen samen. import_id dient alleen om oudere clients te hervatten.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish + agent:operate. Minimale routerollen: editor, viewer.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling. Een geaccepteerde import is nog in behandeling; volg dezelfde import tot ready of failed. Lees het synchrone antwoord.

sosoapi_publish_scheduled_post_now

Publiceer een ingepland bericht direct in plaats van op scheduled_at. Openbaar en niet ongedaan te maken; vereist expected_version. In de wachtrij geplaatst betekent niet gepubliceerd: lees het resultaat.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_query_assets

Zoek mediabestanden in een werkruimte op asset_type, source of tag; geeft een pagina (limit maximaal 100, plus offset) en het totaal terug. Geef workspace_id expliciet mee.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: true. Idempotentiehint: true. Externe-wereldhint: false.
• Zo controleer je het resultaat: lees het synchrone antwoord.

sosoapi_request_provider_insights

Vraag de provider om statistieken voor een account of één bericht over een optioneel datumbereik (maximaal 366 dagen). Geeft een request_id en, indien gecachet, het resultaat terug; vraag anders de status op via sosoapi_get_provider_insight_status.

• Transport: stdio, http.
• Vereiste machtiging: agent:operate. Minimale routerollen: viewer.
• Alleen-lezenhint: false. Idempotentiehint: false. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het platformresultaat of de reden waarom het niet beschikbaar is.

sosoapi_retry_scheduled_post

Probeer een mislukt ingepland bericht opnieuw, eventueel met een nieuwe scheduled_at. Vereist expected_version.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_update_scheduled_post

Bewerk een ingepland bericht dat nog niet is verzonden voor uitvoering (bijschrift, hashtags, media, link, tijd). Vereist expected_version uit de laatste leesactie; een verouderde versie wordt geweigerd.

• Transport: stdio, http.
• Vereiste machtiging: agent:publish. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het definitieve publicatieresultaat; een geaccepteerde planning is nog in behandeling.

sosoapi_upload_asset

Upload een lokale afbeelding of video naar de mediabibliotheek van een werkruimte en registreer deze als mediabestand. Alleen echte bestanden in PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG tot 500 MiB uit de werkmap, tijdelijke map, Pictures/Movies/Videos of SOSOAPI_UPLOAD_ROOTS worden geaccepteerd; bestanden en mappen waarvan de naam met een punt begint worden geweigerd. Geeft de media-id en URL voor Scheduled Post-media terug.

• Transport: stdio.
• Vereiste machtiging: agent:operate. Minimale routerollen: editor.
• Alleen-lezenhint: false. Idempotentiehint: true. Externe-wereldhint: true.
• Zo controleer je het resultaat: lees het synchrone antwoord.