Ferramentas e prompts
Cada ferramenta do servidor MCP, com o endpoint REST equivalente, parâmetros e custo.
O assistente descobre estas ferramentas sozinho. Cada uma é a mesma operação de um endpoint da API REST, com as mesmas regras e custos; os parâmetros são os campos do endpoint (o id do caminho incluído). Os ids vêm de outras ferramentas: projectId de list_projects, o id de um artigo de list_articles, o de um post de list_posts, o de uma imagem de upload_image. Datas são AAAA-MM-DD e horas HH:MM, no fuso do projeto. Toda lista aceita limit e cursor e devolve { data, nextCursor }.
Projetos e planejamento
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
list_projects | GET /projects | — | Grátis | Os projetos da organização que você alcança. |
get_brand | GET /projects/{id}/brand | id | Grátis | A marca publicada do projeto: negócio, oferta, público, voz, termos, pilares, CTAs, glossário, concorrentes, idiomas, padrão de URL e os melhores artigos como exemplo. Leia antes de escrever. |
list_topics | GET /topics | projectId | Grátis | As pautas do plano esperando para ser escritas: título, palavra-chave, pilar, intenção, CTA, o que evitar e data. |
suggest_topics | POST /topics/suggest | projectId, titles (1–20) | Grátis | Sugere pautas à estratégia do projeto; uma pessoa decide quais planejar. |
get_calendar | GET /calendar | projectId | Grátis | O que tem data nos próximos 60 dias: pautas planejadas, artigos agendados e cada destino de post (type). |
get_results | GET /results | projectId | Grátis | Os últimos 28 dias no Search Console, por página: cliques e impressões. |
Artigos
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
list_articles | GET /articles | projectId, status | Grátis | Os artigos de um projeto, com status e datas. |
create_article | POST /articles | projectId, markdown, title, slug, summary, seoTitle, seoDescription, topicId, submit | Grátis | Cria um artigo a partir do Markdown que o agente escreveu. Com topicId, preenche a pauta e herda a data. Vai para revisão, a menos que submit seja false ou o projeto publique direto o trabalho de agentes. Nunca publica. |
get_article | GET /articles/{id} | id | Grátis | Um artigo inteiro: Markdown, revisão, título, slug, URL, resumo, SEO, status, agenda, capa, comentários abertos, o que as verificações automáticas acharam e os posts feitos a partir dele. |
update_article | PATCH /articles/{id} | id, revision, markdown, title, slug, summary, seoTitle, seoDescription, coverImageId | Grátis | Salva uma nova revisão; o que ficar de fora não muda. coverImageId define a capa. Um artigo aprovado ou agendado volta a rascunho. revision diferente da atual é conflito. |
submit_article | POST /articles/{id}/submit | id | Grátis | Manda a última revisão de um rascunho para revisão e avisa quem revisa. |
Comentários
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
list_comments | GET /articles/{id}/comments | id | Grátis | Os comentários de revisão abertos, com respostas. |
create_comment | POST /articles/{id}/comments | id, body, parentId, quote | Grátis | Comenta um artigo, ou responde a um comentário aberto com parentId. @menções avisam as pessoas. |
resolve_comment | POST /comments/{id}/resolve | id | Grátis | Marca um comentário como resolvido. |
Posts: LinkedIn, X e carrossel
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
list_posts | GET /posts | projectId, format | Grátis | Os posts de um projeto, com formato, status, artigo de origem e destinos. |
create_post | POST /posts | format, projectId ou articleId, text, hashtags, parts, slides, caption, destinations | Grátis | Cria um post escrito pelo agente: text (LinkedIn, primeira linha é a manchete), parts (X, 280 caracteres ponderados por parte, link só na última) ou slides (carrossel: chamada 24, título 56, texto 180). |
get_post | GET /posts/{id} | id | Grátis | Um post inteiro: formato, status, revisão, conteúdo, artigo de origem e cada destino com status e data. |
update_post | PATCH /posts/{id} | id, revision, text, hashtags, parts, slides, caption | Grátis | Salva uma nova revisão de um post; o que ficar de fora não muda. Um post aprovado ou agendado volta para revisão. |
render_post | POST /posts/{id}/render | id, destination (instagram, linkedin, tiktok), exportId | Grátis | Gera o arquivo do carrossel no worker do Postline: imagens para Instagram e TikTok, PDF para o LinkedIn. Chame de novo com o exportId até ready; o link vale uma hora. |
Imagens
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
upload_image | POST /images | projectId, base64 ou url, fileName, alt, license (own, licensed, public), credit | Grátis | Adiciona um JPG, PNG ou WebP (até 20 MB) à Mídia, de base64 ou de uma URL https pública. Devolve o Markdown para colocar no artigo. |
Pedem confirmação
As ferramentas abaixo mudam algo que não se desfaz ou que vai ao ar. O assistente deve perguntar antes e só mandar confirm: true depois do sim de quem usa. Pela API REST, confirm não existe: o seu sistema decide.
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
approve_article | POST /articles/{id}/approve | id, revision, confirm: true | Grátis; aprovar pode iniciar os posts de rotina do projeto, que gastam créditos como no app | Aprova a revisão em revisão (revisores, admins e donos). |
schedule_article | POST /articles/{id}/schedule | id, day, time, confirm: true | Grátis | Agenda um artigo aprovado no fuso do projeto. |
schedule_post | POST /posts/{id}/destinations/{destination}/schedule | id, destination, day, time, confirm: true | Grátis | Dá data a um destino de um post, no fuso do projeto. A revisão segue a regra do projeto para agentes. |
delete_article | DELETE /articles/{id} | id, confirm: true | Grátis | Apaga um artigo de vez, com as revisões. Nunca um que um site mostra ou está entregando. |
delete_post | DELETE /posts/{id} | id, confirm: true | Grátis | Apaga um post de vez, enquanto nada dele foi publicado. |
delete_image | DELETE /images/{id} | id, confirm: true | Grátis | Apaga uma imagem da Mídia de vez; um artigo que a tinha como capa fica sem. |
Escritos pelo modelo do Postline
| Ferramenta | REST | Parâmetros | Custo | O que faz |
|---|---|---|---|---|
generate_post | POST /posts/generate | format, projectId, topic, link, script ou articleId, objective, tone, size, images, ratio, destinations | LinkedIn 1 crédito (2 com ilustração ou foto); X 1; carrossel 2 (6 com imagens) | Escreve um post como o Início faz, a partir de um entre topic, link, script ou articleId. Fica pronto em cerca de um minuto; leia com get_post. |
generate_post_images | POST /posts/{id}/images | id, prompt, size (4:5, 1:1, 9:16) | 1 crédito por imagem, até 4 | Desenha até 4 variações para um slide e guarda na Mídia. Coloque uma com update_post. |
objective: leads, authority, educate (padrão), launch, retain, save, engage, hire ou sell. tone: consultative (padrão), direct, didactic ou casual. Para escrever de graça, use create_post: o agente escreve, o Postline só guarda.
Prompts
Prompts prontos que o assistente oferece:
| Prompt | Argumento | O que faz |
|---|---|---|
write-next-planned-article | projectId | Escreve o próximo artigo que o plano espera: lê a pauta e a marca, escreve, cria o artigo, coloca imagens e manda para revisão. |
improve-article | id | Melhora um artigo a partir dos resultados: título e SEO para cliques, seções para profundidade, responde comentários e salva uma nova revisão. |
repurpose-article | id | Transforma um artigo num post de LinkedIn, num carrossel e numa thread do X com create_post, escritos pelo próprio assistente (grátis, sem generate_post). |
Erros
Uma ferramenta que falha responde com isError e um texto que começa pelo mesmo código que a API REST devolve em error.code: not_allowed (o seu papel não permite), insufficient_credits, invalid_input, locked (em revisão ou sendo escrito), conflict, invalid_state, not_found, unavailable ou error. Veja Erros e limites.