Skip to main content
Glama

sapiens_publicar

Publicar uma peça SUA nas SUAS redes (TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord), pelo Distribution da pessoa (assinatura ou convite). Identidade SEMPRE pelo sessionToken. É o mesmo Distribution da tela /dashboard/distribution (a fila de peças à esquerda, a ficha de cada peça numa rede à direita). Sub-actions: 'fila' (a fila da pessoa: cada peça com título, tipo e o estado em cada rede, rascunho, agendado, enviado, publicado, falhou ou descartado, com a legenda e o link de cada uma, o personagem da peça quando ela é de um, e os números que a rede devolveu pro post (views, likes, comentários...) quando já medidos, 1 hora, 1 dia e 7 dias depois de sair; a peça que ela preparou na tela aparece aqui), 'painel' (as redes com conectada ou não, o @, o limite de texto e a régua de cada praça; com handle, a peça: onde ela já está por rede, com estado e link, e a sugestão de onde mandar, as que ficam de fora com o motivo e as que valeria conectar), 'rascunho' (handle + rede + legenda: guarda a legenda de UMA rede pra peça, vazia apaga; acima do limite da rede volta erro com o número), 'publicar' (handle + redes, agora ou agendarPara ISO com fuso; a legenda vai em BLOCOS: text é o corpo, cta a chamada, hashtags sem #, e cada rede leva o que cabe no limite dela, saindo primeiro as hashtags, depois a chamada, e o corpo corta em fim de frase; legendas {rede: texto} passa por cima dos blocos naquela rede; o retorno diz em adaptadas quais redes receberam menos do que foi escrito), 'lista' (o que já saiu: os envios recentes com o estado de cada rede), 'conferir' (postId: pergunta o que cada rede fez e grava o link), 'cancelar' (postId: tira a HORA de um agendado que ainda não saiu; a peça não é cancelada, volta pra fila daquela rede como rascunho, com a mesma legenda, pronta pra publicar agora ou agendar de novo), 'teia' (as regras da Teia da pessoa, do tipo 'quando sai no Instagram, entra na fila do Threads'; sem mais nada lê as regras, com de + para + mudanca=ligar|pausar|apagar mexe numa; quando a peça sai na rede de origem, ela nasce na fila da rede de destino como rascunho, com o corpo da legenda no limite de lá e as hashtags à parte, e ESPERA o clique, nada sai sozinho; filha não tece de novo, e rede onde a peça já esteve, até descartada, fica de fora). Postar de novo não tem action à parte: rascunho ou publicar numa rede onde a peça já saiu abre cartão novo, e o que saiu fica no rastro. A casa confere sozinha o que saiu e avisa a pessoa no sino (e no Telegram, se ela ligou) quando o post sai ou falha. Fluxo: painel com handle, escolhe pela sugestão, publicar, conferir. Só peça da própria pessoa, e só rede conectada (conectar é na tela /dashboard/distribution). Sem custo em Sinapses: o teto é o de publicações por ciclo do plano. Publicar POSTA DE VERDADE na conta da pessoa: confirme redes e legenda com ela antes. A fila da casa é outra tool (sapiens_distribution, admin). Passo a passo: skill publicar.

Input Schema

NameRequiredDescriptionDefault
deNoteia: a rede de origem da regra (id do painel), onde a peça sai primeiro.
ctaNopublicar: a chamada, em bloco à parte. Sai antes do corpo quando não cabe.
paraNoteia: a rede de destino, em cuja fila a peça entra.
redeNorascunho: a rede (id do painel: instagram, tiktok, threads...). Numa conta extra, o destino com a conta: tiktok@2.
textNopublicar: o CORPO da legenda. Ausente usa o título da peça.
redesNopublicar: as redes (ids do painel), só as conectadas. Conta extra vai com a conta: tiktok@2 é o TikTok da conta 2 (painel, contasExtras). Um envio sai por UMA conta: pra publicar na conta 1 e na 2, chame publicar duas vezes.
actionYes
handleNoA peça (img_..., vid_..., car_... pro carrossel inteiro). Obrigatório em rascunho e publicar; em painel traz a peça junto.
postIdNoconferir/cancelar: o id do envio, vindo da lista.
legendaNorascunho: a legenda daquela rede. Vazia apaga o rascunho.
mudancaNoteia: ligar (cria ou despausa), pausar ou apagar a regra de -> para. Ausente = só lê as regras.
hashtagsNopublicar: as hashtags, sem #. São as primeiras a sair onde o limite aperta.
legendasNopublicar: legenda própria por rede ({threads: '...'}, ou {'threads@2': '...'} na conta extra), passa por cima dos blocos naquela rede.
agendarParaNopublicar: data e hora ISO 8601 COM fuso (2026-10-08T19:00:00-03:00). Ausente = agora. Mínimo 5 min à frente.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds substantial context beyond annotations: publishing is a real, irreversible-in-the-world write to a third-party account, has no Sinapses cost but is bounded by the plan's per-cycle publication ceiling, auto-verifies results and notifies on the bell/Telegram, and cancelar only removes the scheduled time rather than deleting the piece. It also discloses the Teia behavior that child pieces wait for a click and never fire alone.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and the destructive-publishing warning are front-loaded, and every clause carries real information, but the body is a single dense run-on spanning all eight sub-actions with no structural breaks, making it hard to scan. Given the tool's surface area some length is justified, yet the lack of separation (bullets or per-action headings) costs it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an eight-action, 14-parameter write tool with no output schema, the description covers each sub-action's inputs, side effects, and return hints (estado por rede, link, `adaptadas`, métricas 1h/1d/7d), plus prerequisites (conexão de rede feita na tela do dashboard) and the cost model. Nothing essential to correct invocation appears missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 93%, so the baseline is 3, and the description adds real semantics: the block model for the legenda (text/cta/hashtags) and its truncation order, 'legendas {rede: texto}' overriding blocks per network, and the `adaptadas` return signal. The 'tiktok@2' extra-account convention and 'um envio sai por UMA conta' are echoed from the schema rather than newly added, keeping it just under a top score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Publicar uma peça SUA nas SUAS redes') and enumerates all eleven target networks plus the account/subscription scope. It also explicitly distinguishes itself from the sibling 'sapiens_distribution' (a fila da casa é outra tool, admin), so an agent can tell the two apart without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit flow ('painel com handle, escolhe pela sugestão, publicar, conferir') and defines selection conditions for each of the eight sub-actions, including the notable exclusion 'Postar de novo não tem action à parte' and the constraint 'Só peça da própria pessoa, e só rede conectada'. It escalates required caution ('Publicar POSTA DE VERDADE... confirme redes e legenda com ela antes').

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.