# Naslag voor MCP-tools

- [Naslag voor MCP-tools](https://sosoapi.ai/nl/docs/mcp): Vind toolinvoer, uitvoer, profielen en lokale of gehoste beschikbaarheid.
- [Gebruikersprofiel ophalen](https://sosoapi.ai/nl/docs/mcp/get-user-profile): MCP: Gebruikersprofiel ophalen. Lees het eigen profiel van de aangemelde gebruiker (weergavenaam, tijdzone, avatar, thema); profile is null zolang er geen profiel bestaat.
- [Gebruikersprofiel bijwerken](https://sosoapi.ai/nl/docs/mcp/update-user-profile): MCP: Gebruikersprofiel bijwerken. Wijzig het eigen profiel van de aangemelde gebruiker (display_name, timezone, avatar_url, theme). Verstuur alleen de velden die moeten veranderen.
- [Avatarupload ondertekenen](https://sosoapi.ai/nl/docs/mcp/sign-avatar-upload): MCP: Avatarupload ondertekenen. Haal een ondertekende URL op om een nieuwe avatarafbeelding voor de aangemelde gebruiker te uploaden (filename en content_type zijn verplicht). Wijzigt het profiel op zichzelf niet.
- [API-sleutels weergeven](https://sosoapi.ai/nl/docs/mcp/list-api-keys): MCP: API-sleutels weergeven. Toon de API-sleutels van de gebruiker (naam, laatste 4 tekens, status, vervaldatum, herkomstketen); stel include_authority in om ook de bevoegdheden en werkruimtebeperking per sleutel op te halen. Geheimen worden nooit teruggegeven. Vereist de machtiging Manage API keys; een PAT kan dit niet gebruiken.
- [API-sleutel maken](https://sosoapi.ai/nl/docs/mcp/create-api-key): MCP: API-sleutel maken. Maak een persoonlijke toegangssleutel met gekozen bevoegdheden (agent:operate, agent:publish, agent:engage), een optionele workspace_ids-beperking en een geldigheidsduur van maximaal 365 dagen; het geheim wordt één keer teruggegeven en kan niet opnieuw worden gelezen. Een agent kan alleen eigen bevoegdheden toekennen, voor maximaal 30 dagen, en de sleutel werkt niet meer zodra die machtiging eindigt. Vereist de machtiging Manage API keys; een PAT kan dit niet gebruiken.
- [API-sleutel verlengen](https://sosoapi.ai/nl/docs/mcp/extend-api-key): MCP: API-sleutel verlengen. Stel een latere vervaldatum (expires_at) in voor een API-sleutel op id: maximaal 365 dagen vanaf nu, of 30 voor een door een agent gemaakte sleutel. Een agent kan alleen sleutels verlengen die met zijn eigen machtiging zijn gemaakt. Vereist de machtiging Manage API keys.
- [API-sleutel vernieuwen](https://sosoapi.ai/nl/docs/mcp/renew-api-key): MCP: API-sleutel vernieuwen. Maak een opvolger voor een API-sleutel (id) met een nieuw geheim dat één keer wordt teruggegeven en dezelfde bevoegdheden en werkruimtebeperking, eventueel met een nieuwe naam of geldigheidsduur (maximaal 365 dagen, 30 voor een door een agent gemaakte sleutel). De oorspronkelijke sleutel wordt niet ingetrokken. Vereist de machtiging Manage API keys.
- [API-sleutel intrekken](https://sosoapi.ai/nl/docs/mcp/revoke-api-key): MCP: API-sleutel intrekken. Trek een API-sleutel op id in zodat deze direct niet meer werkt; een eerder ingetrokken sleutel meldt already_revoked. Een agent kan alleen sleutels intrekken die met zijn eigen machtiging zijn gemaakt. Vereist de machtiging Manage API keys.
- [Factureringsstatus ophalen](https://sosoapi.ai/nl/docs/mcp/get-billing-status): MCP: Factureringsstatus ophalen. 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.
- [Commerciële toegang ophalen](https://sosoapi.ai/nl/docs/mcp/get-commercial-access): MCP: Commerciële toegang ophalen. Lees de abonnements- en quotagegevens van het factureringsaccount van één werkruimte, plus de commercial_access_mode (off, shadow of enforce).
- [Organisatiecontext ophalen](https://sosoapi.ai/nl/docs/mcp/get-organization-context): MCP: Organisatiecontext ophalen. 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.
- [Werkruimte maken](https://sosoapi.ai/nl/docs/mcp/create-workspace): MCP: Werkruimte maken. Maak een werkruimte in een organisatie waarvan je eigenaar of beheerder bent. Geef organization_id mee als je lid bent van meerdere organisaties. Gebruik de teruggegeven id voor volgende aanroepen: neem niet aan dat de nieuwe werkruimte actief wordt.
- [Werkruimtecontext ophalen](https://sosoapi.ai/nl/docs/mcp/get-workspace-context): MCP: Werkruimtecontext ophalen. 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.
- [Werkruimte bijwerken](https://sosoapi.ai/nl/docs/mcp/update-workspace): MCP: Werkruimte bijwerken. Wijzig de naam of slug van een werkruimte. Alleen de werkruimte-eigenaar.
- [Organisaties weergeven](https://sosoapi.ai/nl/docs/mcp/list-organizations): MCP: Organisaties weergeven. Toon de organisaties waarvan de aangemelde gebruiker lid is, met de ids die organisatiegebonden tools als organization_id gebruiken.
- [Organisatieverbindingen weergeven](https://sosoapi.ai/nl/docs/mcp/list-organization-connections): MCP: Organisatieverbindingen weergeven. Toon de providerverbindingen (Meta, Instagram, Threads, YouTube) van een organisatie en hun status. Vereist organization_id.
- [Organisatieverbinding beoordelen](https://sosoapi.ai/nl/docs/mcp/review-organization-connection): MCP: Organisatieverbinding beoordelen. Lees de provideraccounts en pagina's die door één openstaande verbindingsactie (operation_id) zijn gevonden, zodat ze kunnen worden beoordeeld. Alleen lezen: een persoon bevestigt de verbinding in de webapp.
- [Organisatiekanalen weergeven](https://sosoapi.ai/nl/docs/mcp/list-organization-channels): MCP: Organisatiekanalen weergeven. Toon de kanalen (verbonden provideraccounts) van een organisatie en aan welke werkruimte elk kanaal is gekoppeld.
- [Kanaalverplaatsing vooraf bekijken](https://sosoapi.ai/nl/docs/mcp/preview-organization-channel-move): MCP: Kanaalverplaatsing vooraf bekijken. Proefcontrole: bekijk of een kanaal naar een andere werkruimte kan worden verplaatst en toon wat dit verhindert. Wijzigt niets.
- [Werkruimteleden weergeven](https://sosoapi.ai/nl/docs/mcp/list-workspace-members): MCP: Werkruimteleden weergeven. Toon de leden en openstaande uitnodigingen van een werkruimte.
- [Feedback indienen](https://sosoapi.ai/nl/docs/mcp/submit-feedback): MCP: Feedback indienen. Stuur namens de gebruiker productfeedback (type bug, feature of general; maximaal 4,000 tekens) naar het SosoAPI-team. Gebruik dit alleen op verzoek van de gebruiker.
- [Meldingsvoorkeuren ophalen](https://sosoapi.ai/nl/docs/mcp/get-notification-preferences): MCP: Meldingsvoorkeuren ophalen. Lees de meldingsinstellingen van de gebruiker (momenteel of er een e-mail wordt verzonden wanneer een bericht mislukt).
- [Meldingsvoorkeuren bijwerken](https://sosoapi.ai/nl/docs/mcp/update-notification-preferences): MCP: Meldingsvoorkeuren bijwerken. Wijzig de meldingsinstellingen van de gebruiker (email_post_failed aan of uit).
- [Inboxmeldingen weergeven](https://sosoapi.ai/nl/docs/mcp/list-inbox-notifications): MCP: Inboxmeldingen weergeven. Lees de inbox van de gebruiker in de app, nieuwste eerst (maximaal 50), eventueel alleen ongelezen meldingen of één type.
- [Verbonden accounts weergeven](https://sosoapi.ai/nl/docs/mcp/list-connected-accounts): MCP: Verbonden accounts weergeven. 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.
- [Socialmedia-account ontkoppelen](https://sosoapi.ai/nl/docs/mcp/disconnect-social-account): MCP: Socialmedia-account ontkoppelen. Ontkoppel een socialmedia-account van zijn werkruimte (alleen de werkruimte-eigenaar). Publicatie ernaar stopt totdat een persoon het opnieuw verbindt met `sosoapi connect`.
- [Automatische accountsynchronisatie instellen](https://sosoapi.ai/nl/docs/mcp/set-social-account-auto-sync): MCP: Automatische accountsynchronisatie instellen. Schakel automatische synchronisatie in of uit voor één verbonden socialmedia-account (rol editor). Publiceert niets.
- [Accountblokkering opheffen](https://sosoapi.ai/nl/docs/mcp/clear-social-account-block): MCP: Accountblokkering opheffen. Hef een wachttijd van de provider voor een account op zodat publicatie kan worden hervat. Mislukte berichten worden niet opnieuw geprobeerd; gebruik daarvoor sosoapi_retry_scheduled_post.
- [Mediabestanden doorzoeken](https://sosoapi.ai/nl/docs/mcp/query-assets): MCP: Mediabestanden doorzoeken. 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.
- [Mediabestand ophalen](https://sosoapi.ai/nl/docs/mcp/get-asset): MCP: Mediabestand ophalen. Lees één mediabestand op id: metadata en een kort geldige voorbeeld-URL.
- [Mediabestand registreren](https://sosoapi.ai/nl/docs/mcp/create-asset): MCP: Mediabestand registreren. Registreer een mediarecord voor media of tekst die je al host (asset_url, asset_type). Dit uploadt niets: gebruik sosoapi_upload_asset voor een lokaal bestand of sosoapi_import_asset_url om SosoAPI een openbare URL te laten ophalen. Geef workspace_id mee (zonder dit veld geweigerd zodra expliciete selectie wordt afgedwongen). Optionele idempotency_key.
- [Mediabestand bijwerken](https://sosoapi.ai/nl/docs/mcp/update-asset): MCP: Mediabestand bijwerken. Wijzig de titel, beschrijving of tags van een mediabestand (rol editor).
- [Mediabestand verwijderen](https://sosoapi.ai/nl/docs/mcp/delete-asset): MCP: Mediabestand verwijderen. Verwijder één mediabestand op id uit de werkruimtebibliotheek. Alleen de werkruimte-eigenaar.
- [Mediabestanden weergeven](https://sosoapi.ai/nl/docs/mcp/list-assets): MCP: Mediabestanden weergeven. Toon de mediabestanden van een werkruimte, gefilterd op type (video, image, audio, cover, thumbnail, frame, video-source, branding) of customer_ready_only, met next_offset-paginering. workspace_id is verplicht.
- [Mediabestand via URL importeren](https://sosoapi.ai/nl/docs/mcp/import-asset-url): MCP: Mediabestand via URL importeren. 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.
- [Importstatus van mediabestand ophalen](https://sosoapi.ai/nl/docs/mcp/get-asset-import-status): MCP: Importstatus van mediabestand ophalen. 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.
- [Niet-gekoppelde opslagobjecten weergeven](https://sosoapi.ai/nl/docs/mcp/list-orphan-assets): MCP: Niet-gekoppelde opslagobjecten weergeven. Toon opgeslagen werkruimteobjecten waarnaar geen mediarecord verwijst (opslag opschonen), gepagineerd met een vervolgtoken. Alleen de werkruimte-eigenaar.
- [Niet-gekoppelde opslagobjecten verwijderen](https://sosoapi.ai/nl/docs/mcp/delete-orphan-assets): MCP: Niet-gekoppelde opslagobjecten verwijderen. Verwijder geselecteerde niet-geregistreerde opslagobjecten op sleutel. Alleen de werkruimte-eigenaar; toon ze eerst met sosoapi_list_orphan_assets.
- [Opslaginventaris van mediabestanden ophalen](https://sosoapi.ai/nl/docs/mcp/get-asset-storage-inventory): MCP: Opslaginventaris van mediabestanden ophalen. Lees een gepagineerde inventaris van de geregistreerde mediabestanden en opgeslagen objecten van een werkruimte voor een opslagcontrole.
- [Export van mediabestanden maken](https://sosoapi.ai/nl/docs/mcp/create-asset-export): MCP: Export van mediabestanden maken. Exporteer geselecteerde mediabestanden (asset_ids) als manifest. De modus export_verify_then_purge bereidt ze voor op latere definitieve verwijdering. Optionele idempotency_key.
- [Export van mediabestanden verifiëren](https://sosoapi.ai/nl/docs/mcp/verify-asset-export): MCP: Export van mediabestanden verifiëren. Start de verificatie van een media-export (export_id). Een export moet zijn geverifieerd voordat definitieve verwijdering kan worden aangevraagd.
- [Exportstatus van mediabestanden ophalen](https://sosoapi.ai/nl/docs/mcp/get-asset-export-status): MCP: Exportstatus van mediabestanden ophalen. Lees de status van een media-export: exported, verification_required, verifying, verified of failed.
- [Definitieve verwijdering van mediabestanden aanvragen](https://sosoapi.ai/nl/docs/mcp/request-asset-purge): MCP: Definitieve verwijdering van mediabestanden aanvragen. Vraag definitieve verwijdering aan van de opgeslagen bytes van mediabestanden in een geverifieerde export (export_id, asset_ids; confirm_history_loss kan vereist zijn). Alleen de werkruimte-eigenaar; verwijdering is onomkeerbaar.
- [Definitieve verwijdering van mediabestanden opnieuw proberen](https://sosoapi.ai/nl/docs/mcp/retry-asset-purge): MCP: Definitieve verwijdering van mediabestanden opnieuw proberen. Probeer een gestopt verzoek tot definitieve verwijdering opnieuw (purge_request_id). Alleen de werkruimte-eigenaar.
- [Projecten weergeven](https://sosoapi.ai/nl/docs/mcp/list-projects): MCP: Projecten weergeven. Toon de projecten van een werkruimte (een optionele laag voor herkomst en standaardaccounts) en welk project actief is.
- [Project ophalen](https://sosoapi.ai/nl/docs/mcp/get-project): MCP: Project ophalen. Lees één project op id: naam, levenscyclusstatus en de versies van levenscyclus en standaardinstellingen die latere schrijfhandelingen vereisen.
- [Project maken](https://sosoapi.ai/nl/docs/mcp/create-project): MCP: Project maken. Maak een project in een werkruimte. Alleen de werkruimte-eigenaar; optionele idempotency_key.
- [Project bijwerken](https://sosoapi.ai/nl/docs/mcp/update-project): MCP: Project bijwerken. Wijzig de naam van een project (alleen de naam is bewerkbaar). Alleen de werkruimte-eigenaar.
- [Actief project instellen](https://sosoapi.ai/nl/docs/mcp/set-active-project): MCP: Actief project instellen. Stel in welk project voor de gebruiker actief is (een standaard op de server).
- [Standaardaccounts van project ophalen](https://sosoapi.ai/nl/docs/mcp/get-project-account-defaults): MCP: Standaardaccounts van project ophalen. Lees de standaardaccounts van een project en de afwijkingen per account, met de defaults_version die de volgende vervanging vereist.
- [Standaardaccounts van project vervangen](https://sosoapi.ai/nl/docs/mcp/replace-project-account-defaults): MCP: Standaardaccounts van project vervangen. Vervang in één stap de standaardaccounts en afwijkingen van een project. Vereist expected_defaults_version uit de laatste leesactie en een idempotency_key (rol editor).
- [Project archiveren](https://sosoapi.ai/nl/docs/mcp/archive-project): MCP: Project archiveren. Archiveer een project zonder de Scheduled Posts ervan te wijzigen. Annuleer de betreffende Scheduled Post apart om een bericht te stoppen. Alleen de werkruimte-eigenaar; geef expected_lifecycle_version en een idempotency_key mee.
- [Project uit archief herstellen](https://sosoapi.ai/nl/docs/mcp/unarchive-project): MCP: Project uit archief herstellen. Heractiveer een gearchiveerd project. Hiermee hervat of verplaats je geen berichten; beheer die via Scheduled Posts. Alleen de werkruimte-eigenaar; geef expected_lifecycle_version en een idempotency_key mee.
- [Projectlevenscyclus ophalen](https://sosoapi.ai/nl/docs/mcp/get-project-lifecycle-history): MCP: Projectlevenscyclus ophalen. Lees de levenscyclusgebeurtenissen van een project (zoals archiveren en herstellen), maximaal 200.
- [Projectprofiel ophalen](https://sosoapi.ai/nl/docs/mcp/get-project-profile): MCP: Projectprofiel ophalen. Lees het merkprofiel van een project (slogan, schrijfstijl, doelgroep, doelen, kleurenpalet en meer); profile is null als er geen profiel bestaat.
- [Projectprofiel bijwerken](https://sosoapi.ai/nl/docs/mcp/update-project-profile): MCP: Projectprofiel bijwerken. Werk velden van het merkprofiel van een project bij. Weggelaten velden blijven ongewijzigd. Vereist expected_profile_version uit de laatste leesactie en een idempotency_key (rol editor).
- [Projectmediabestanden weergeven](https://sosoapi.ai/nl/docs/mcp/list-project-assets): MCP: Projectmediabestanden weergeven. Toon mediabestanden die aan een project zijn gekoppeld met de relatie per koppeling (identity, source of reference), met cursorpaginering.
- [Mediabestand aan project koppelen](https://sosoapi.ai/nl/docs/mcp/link-project-asset): MCP: Mediabestand aan project koppelen. Koppel een bestaand mediabestand aan een project als identity, source of reference. Rol editor; idempotency_key is verplicht.
- [Mediabestand van project loskoppelen](https://sosoapi.ai/nl/docs/mcp/unlink-project-asset): MCP: Mediabestand van project loskoppelen. Verwijder de koppeling van een mediabestand met een project; het bestand zelf blijft behouden. idempotency_key is verplicht.
- [Projectaccounts weergeven](https://sosoapi.ai/nl/docs/mcp/list-project-accounts): MCP: Projectaccounts weergeven. Toon de socialmedia-accounts die aan een project zijn gekoppeld, met cursorpaginering.
- [Account aan project koppelen](https://sosoapi.ai/nl/docs/mcp/link-project-account): MCP: Account aan project koppelen. Koppel een verbonden socialmedia-account aan een project. Rol editor; idempotency_key is verplicht.
- [Account van project loskoppelen](https://sosoapi.ai/nl/docs/mcp/unlink-project-account): MCP: Account van project loskoppelen. Verwijder de koppeling van een socialmedia-account met een project; het account blijft verbonden. idempotency_key is verplicht.
- [Projectexport maken](https://sosoapi.ai/nl/docs/mcp/create-project-export): MCP: Projectexport maken. Start een projectexport (alleen de werkruimte-eigenaar); vraag via sosoapi_get_project_export_status de download-URL op. idempotency_key is verplicht.
- [Status van projectexport ophalen](https://sosoapi.ai/nl/docs/mcp/get-project-export-status): MCP: Status van projectexport ophalen. Lees een projectexport (export_id): queued, processing, completed (met een kort geldige download-URL) of failed. Alleen de werkruimte-eigenaar.
- [Publicaties met aandachtspunten weergeven](https://sosoapi.ai/nl/docs/mcp/list-publication-attentions): MCP: Publicaties met aandachtspunten weergeven. Toon werkruimtepublicaties die aandacht vereisen, gefilterd op status (open of resolved) of scheduled_post_id, gepagineerd met offset.
- [Publicatiecredits voor X ophalen](https://sosoapi.ai/nl/docs/mcp/get-x-usage): MCP: Publicatiecredits voor X ophalen. 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.
- [Ingeplande berichten weergeven](https://sosoapi.ai/nl/docs/mcp/list-scheduled-posts): MCP: Ingeplande berichten weergeven. 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.
- [Ingepland bericht ophalen](https://sosoapi.ai/nl/docs/mcp/get-scheduled-post): MCP: Ingepland bericht ophalen. 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.
- [Geschiktheid van ingepland bericht ophalen](https://sosoapi.ai/nl/docs/mcp/get-scheduled-post-eligibility): MCP: Geschiktheid van ingepland bericht ophalen. 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.
- [Ingepland bericht maken](https://sosoapi.ai/nl/docs/mcp/create-scheduled-post): MCP: Ingepland bericht maken. 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.
- [Meerdere ingeplande berichten maken](https://sosoapi.ai/nl/docs/mcp/bulk-create-scheduled-posts): MCP: Meerdere ingeplande berichten maken. 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.
- [Ingepland bericht bijwerken](https://sosoapi.ai/nl/docs/mcp/update-scheduled-post): MCP: Ingepland bericht bijwerken. 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.
- [Ingepland bericht nu publiceren](https://sosoapi.ai/nl/docs/mcp/publish-scheduled-post-now): MCP: Ingepland bericht nu publiceren. 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.
- [Ingepland bericht opnieuw proberen](https://sosoapi.ai/nl/docs/mcp/retry-scheduled-post): MCP: Ingepland bericht opnieuw proberen. Probeer een mislukt ingepland bericht opnieuw, eventueel met een nieuwe scheduled_at. Vereist expected_version.
- [Ingepland bericht verwijderen](https://sosoapi.ai/nl/docs/mcp/delete-scheduled-post): MCP: Ingepland bericht verwijderen. Verwijder een ongepubliceerd ingepland bericht (scheduled, needs_reschedule, failed of cancelled). Agents kunnen eenmaal gepubliceerde providerinhoud niet verwijderen. Vereist expected_version.
- [Ingepland bericht annuleren](https://sosoapi.ai/nl/docs/mcp/cancel-scheduled-post): MCP: Ingepland bericht annuleren. 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.
- [Verwijderingsverzoek intrekken](https://sosoapi.ai/nl/docs/mcp/withdraw-scheduled-post-delete): MCP: Verwijderingsverzoek intrekken. Trek een gestopt verwijderingsverzoek via Instagram Login in en behoud het gepubliceerde bericht. Vereist expected_version.
- [Dashboardaantallen ophalen](https://sosoapi.ai/nl/docs/mcp/get-dashboard-counts): MCP: Dashboardaantallen ophalen. Lees de operationele aantallen van een werkruimte: ingeplande berichten, recente taken en verbonden accounts.
- [Gevonden berichten weergeven](https://sosoapi.ai/nl/docs/mcp/list-monitored-posts): MCP: Gevonden berichten weergeven. 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.
- [Berichtreacties weergeven](https://sosoapi.ai/nl/docs/mcp/list-post-comments): MCP: Berichtreacties weergeven. 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.
- [Providerstatistieken aanvragen](https://sosoapi.ai/nl/docs/mcp/request-provider-insights): MCP: Providerstatistieken aanvragen. 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.
- [Status van providerstatistieken ophalen](https://sosoapi.ai/nl/docs/mcp/get-provider-insight-status): MCP: Status van providerstatistieken ophalen. Lees een statistiekaanvraag (request_id): queued, processing, completed (met het providerresultaat en beschikbaarheid per meetwaarde) of failed.
- [Instagram OAuth starten](https://sosoapi.ai/nl/docs/mcp/start-instagram-oauth): MCP: Instagram OAuth starten. Haal de authorize_url van de provider op die een persoon moet openen om een Instagram-account te verbinden. Geef workspace_id mee. Er wordt niets verbonden totdat die persoon in de browser toestemming geeft en bevestigt.
- [Instagram OAuth vernieuwen](https://sosoapi.ai/nl/docs/mcp/refresh-instagram-oauth): MCP: Instagram OAuth vernieuwen. Vernieuw het toegangstoken van een Instagram-verbinding (eventueel voor één social_account_id); meldt of de vernieuwing is geslaagd en wat de nieuwe vervaldatum is.
- [Threads OAuth starten](https://sosoapi.ai/nl/docs/mcp/start-threads-oauth): MCP: Threads OAuth starten. Haal de authorize_url van de provider op die een persoon moet openen om een Threads-account te verbinden. Geef workspace_id mee. Er wordt niets verbonden totdat die persoon in de browser toestemming geeft en bevestigt.
- [Threads OAuth vernieuwen](https://sosoapi.ai/nl/docs/mcp/refresh-threads-oauth): MCP: Threads OAuth vernieuwen. Vernieuw het toegangstoken van een Threads-verbinding (eventueel voor één social_account_id); meldt of de vernieuwing is geslaagd en wat de nieuwe vervaldatum is.
- [Threads OAuth controleren](https://sosoapi.ai/nl/docs/mcp/check-threads-oauth): MCP: Threads OAuth controleren. Lees de gezondheid van de Threads-verbinding: verbonden status, vervaldatum, bereik en mogelijkheid tot vernieuwen. Geef workspace_id mee.
- [Meta OAuth starten](https://sosoapi.ai/nl/docs/mcp/start-meta-oauth): MCP: Meta OAuth starten. Haal de authorize_url van de provider op die een persoon moet openen om een Facebook-pagina of Instagram via Facebook te verbinden (connection_intent). Geef workspace_id mee. Er wordt niets verbonden totdat die persoon in de browser toestemming geeft en bevestigt.
- [Meta OAuth vernieuwen](https://sosoapi.ai/nl/docs/mcp/refresh-meta-oauth): MCP: Meta OAuth vernieuwen. Verifieer een verbinding met Facebook/Meta (social_account_id) opnieuw en rapporteer capability_verified.
- [YouTube OAuth starten](https://sosoapi.ai/nl/docs/mcp/start-youtube-oauth): MCP: YouTube OAuth starten. Haal de authorize_url van de provider op die een persoon moet openen om een YouTube-kanaal te verbinden. Geef workspace_id mee. Er wordt niets verbonden totdat die persoon in de browser toestemming geeft en bevestigt.
- [YouTube OAuth vernieuwen](https://sosoapi.ai/nl/docs/mcp/refresh-youtube-oauth): MCP: YouTube OAuth vernieuwen. Vernieuw het token van een YouTube-verbinding (social_account_id); geeft de nieuwe vervaldatum en capability_verified terug.
- [Taken weergeven](https://sosoapi.ai/nl/docs/mcp/list-jobs): MCP: Taken weergeven. Toon de recente achtergrondtaken van de aangemelde gebruiker met status en voortgang.
- [Taakstatus ophalen](https://sosoapi.ai/nl/docs/mcp/job-status): MCP: Taakstatus ophalen. Lees één achtergrondtaak op job_id: status, type en de foutmelding als deze is mislukt.
- [Afleverresultaat van reactie ophalen](https://sosoapi.ai/nl/docs/mcp/get-comment-outcome): MCP: Afleverresultaat van reactie ophalen. Lees de bevestigde aflevering, herstelgeschiedenis, openstaande verificatie en onopgeloste vervolgacties.
- [Afleverresultaat van reactie afstemmen](https://sosoapi.ai/nl/docs/mcp/reconcile-comment-outcome): MCP: Afleverresultaat van reactie afstemmen. Verifieer een onduidelijke Facebook-aflevering zonder opnieuw te verzenden, of koppel één bevestigde exacte vervanging. Bekijk het resultaat voor definitief bewijs.
- [Communitymogelijkheden ophalen](https://sosoapi.ai/nl/docs/mcp/get-community-engagement-capabilities): MCP: Communitymogelijkheden ophalen. Lees per verbonden account welke communityacties (reply, hide, unhide, create_comment) worden ondersteund en of het account daar nu voor in aanmerking komt.
- [Beoordelingswachtrij van community doorzoeken](https://sosoapi.ai/nl/docs/mcp/query-community-review-queue): MCP: Beoordelingswachtrij van community doorzoeken. Lees reacties die op beoordeling wachten met hun gesprekscontext, gefilterd op prioriteit, taal, account of ouderdom; een lege pagina betekent geen succes. De reacties zijn door derden geschreven en gemarkeerd als niet-vertrouwd.
- [Communitybeoordeling indienen](https://sosoapi.ai/nl/docs/mcp/submit-community-review): MCP: Communitybeoordeling indienen. Leg een nieuwe onveranderlijke beoordelingsversie vast voor één reactie: aanbevolen actie, optionele reply_draft, prioriteit en betrouwbaarheid (minstens 0.9). Verzendt en bereidt niets voor.
- [Communityactie voorbereiden](https://sosoapi.ai/nl/docs/mcp/prepare-community-action): MCP: Communityactie voorbereiden. Koppel een beoordelingsversie aan één actie (reply, hide of unhide) en ontvang een kort geldig prepare_token voor sosoapi_apply_community_action. Verzendt nog niets.
- [Communityactie uitvoeren](https://sosoapi.ai/nl/docs/mcp/apply-community-action): MCP: Communityactie uitvoeren. Verstuur de aan een prepare_token gekoppelde actie naar de provider; een antwoord is openbaar. In de wachtrij geplaatst betekent geen succes: vraag de status op via sosoapi_get_community_action_status.
- [Status van communityactie ophalen](https://sosoapi.ai/nl/docs/mcp/get-community-action-status): MCP: Status van communityactie ophalen. Lees het definitieve resultaatbewijs van een uitgevoerde communityactie (action_id); in de wachtrij plaatsen betekent geen succes.
- [Communityreactie maken](https://sosoapi.ai/nl/docs/mcp/create-comment): MCP: Communityreactie maken. Zet één exacte reactie op een canoniek bericht of een canonieke reactie in de wachtrij; de status bewijst geen succes bij de provider.
- [Status van communityreactie ophalen](https://sosoapi.ai/nl/docs/mcp/get-comment-action-status): MCP: Status van communityreactie ophalen. Lees het opgeschoonde definitieve resultaatbewijs van een directe reactieactie.
- [Communityoverzicht ophalen](https://sosoapi.ai/nl/docs/mcp/get-community-engagement-summary): MCP: Communityoverzicht ophalen. Lees het operationele communityoverzicht van een werkruimte: uitvoeringsmodus, achterstand, responstijden, actiestatussen en providerlimieten.
- [Eén afbeelding via een URL publiceren](https://sosoapi.ai/nl/docs/mcp/post-image-url): MCP: Eén afbeelding via een URL publiceren. 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.
- [Lokale afbeelding of video uploaden](https://sosoapi.ai/nl/docs/mcp/upload-asset): MCP: Lokale afbeelding of video uploaden. 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.