MCP: Post scheduler
Schedule and publish social posts through the MCP. 10 tools.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
cancel-scheduled-post
Cancela um post agendado (status SCHEDULED). Se ele faz parte de uma série recorrente, a série acaba (nenhuma ocorrência nova é criada). Posts já publicados não são apagados da rede.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
postId | yes | ID do post agendado (list-scheduled-posts) |
get-tiktok-creator-info
Opções atuais da conta TikTok antes de postar: nickname, @username, privacyLevelOptions (privacidades aceitas), interações desligadas pelo criador (comment/duet/stitch) e duração máxima do vídeo. Leia antes de cada post no TikTok.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | Conta TikTok (list-social-connections platform TIKTOK). |
list-scheduled-posts
Posts do agendador de publicações do workspace (Instagram, TikTok, YouTube), por data: status, tipo, mídia, legenda, erro, link (YouTube), recorrência (cron) e série. Filtre por status (padrão: todos). Tela: XBASE → Publicações.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
status | no | — |
platform | no | Filtra por rede. Padrão: todas. |
take | no | Quantidade (padrão 30, máximo 100) |
list-social-connections
Contas conectadas no hub de publicações do workspace, de todas as redes (Instagram, TikTok, YouTube): connectionId, rede, nome, @handle e status. Use o connectionId em schedule-social-post e publish-social-post-now. Tela: XBASE → Publicações.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
platform | no | Filtra por rede. Padrão: todas. |
publish-social-post-now
AÇÃO EXTERNA — publica agora no Instagram, TikTok ou YouTube (mesmos campos de schedule-social-post, sem data). Instagram e YouTube voltam PUBLISHED (YouTube com url do vídeo). TikTok volta PROCESSING: a TikTok processa o vídeo por alguns minutos; acompanhe com list-scheduled-posts. Contas: list-social-connections. Tela: XBASE → Publicações.
No parameters.
schedule-social-post
AÇÃO EXTERNA — agenda um post no Instagram, TikTok ou YouTube do workspace; na data, ele é publicado na conta escolhida. mediaUrl precisa ser uma URL pública (https) que a rede consiga baixar: use a saída de uma produção do Estúdio (studio_get_production) ou de upload-workspace-file. Instagram: FEED/REELS/STORY (imagem JPEG; Reels exige vídeo); carrossel com mediaType CAROUSEL e mediaUrls (2 a 10 JPEG, sem mediaUrl); recurrence repete por cron (só Instagram). TikTok: postType VIDEO, mediaType VIDEO e tiktok.privacyLevel (consulte get-tiktok-creator-info antes). YouTube: postType SHORT ou VIDEO, mediaType VIDEO, caption = descrição e youtube { title, privacyStatus, madeForKids }. Contas: list-social-connections. Tela: XBASE → Publicações.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
platform | no | Rede. Padrão INSTAGRAM. |
connectionId | yes | Conta/canal conectado (list-social-connections). |
postType | yes | Instagram: FEED, REELS ou STORY. TikTok: VIDEO. YouTube: SHORT (vertical, até 3 min) ou VIDEO. |
mediaType | yes | TikTok e YouTube: VIDEO. CAROUSEL só no feed do Instagram. |
mediaUrl | no | Mídia única. Não use no carrossel. |
mediaUrls | no | Só carrossel do Instagram: 2 a 10 imagens JPEG, na ordem. |
caption | no | Instagram: legenda (2200; story ignora). TikTok: título/legenda (2200). YouTube: descrição (5000). |
tiktok | no | Obrigatório com platform TIKTOK. Interações desligadas por padrão, como na tela. |
youtube | no | Obrigatório com platform YOUTUBE. |
scheduledAt | no | Data e hora (ISO 8601, futuro). Obrigatório sem recurrence. |
recurrence | no | Só Instagram. Repetição; com ela, scheduledAt é opcional (a primeira ocorrência do cron). |
youtube-analytics-report
Relatório do YouTube Analytics do canal (ou de um vídeo, com videoId). Relatórios prontos: summary (views, minutos assistidos, duração média, % assistida, inscritos ganhos/perdidos, likes, comentários, shares), daily (série por dia), top_videos (ranking com título), traffic_sources (origem: busca, sugeridos, Shorts, externo…), content_type (Shorts x vídeos x lives), demographics (idade e gênero, % de espectadores), geography (países), devices (celular, computador, TV), playback_locations, subscription_status (inscritos x não inscritos), retention (curva de retenção; exige videoId). custom: informe metrics/dimensions/filters/sort da API do YouTube Analytics. Datas YYYY-MM-DD; padrão últimos 28 dias. Canal conectado antes da liberação das métricas precisa reconectar.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
report | no | — |
startDate | no | — |
endDate | no | — |
videoId | no | Restringe o relatório a um vídeo (obrigatório em retention). |
metrics | no | custom (ou sobrescreve o pronto): ex. "views,estimatedMinutesWatched". |
dimensions | no | custom: ex. "day", "video", "country". |
filters | no | custom: ex. "country==BR". |
sort | no | custom: ex. "-views". |
maxResults | no | — |
youtube-channel-overview
Visão geral de um canal do YouTube conectado: nome, @handle, inscritos, visualizações totais, número de vídeos, país, data de criação e se as métricas do YouTube Analytics estão liberadas (analyticsAvailable).
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
youtube-get-video
Detalhe de um vídeo do canal: título, descrição, tags, duração, privacidade e estatísticas públicas.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
videoId | yes | ID do vídeo (youtube-list-videos). |
youtube-list-videos
Vídeos do canal, do mais novo ao mais antigo, com visualizações, curtidas, comentários, duração, privacidade, link e se provavelmente é Short (até 3 min). Paginado: até 50 por página (nextPageToken).
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
limit | no | Vídeos por página (padrão 20). |
pageToken | no | nextPageToken da página anterior. |