MCP: Instagram
Instagram accounts, profile, comments and DM automations through the MCP. 11 tools.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
create-dm-automation-rule
Cria uma automação de DM numa conta do Instagram do workspace: quando um comentário tiver uma das palavras-chave, a pessoa recebe uma DM. Modo FIXED envia replyMessage; modo AGENT passa a conversa ao agente (agentId). scope SPECIFIC_POST exige postId.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
keywords | yes | 1 a 20 palavras-chave (até 100 caracteres cada) |
scope | yes | ANY_POST = qualquer post; SPECIFIC_POST = só o post de postId |
postId | no | ID do post (obrigatório com SPECIFIC_POST) |
mode | no | FIXED (padrão) = mensagem fixa; AGENT = o agente responde |
replyMessage | no | Mensagem da DM (modo FIXED, até 1000 caracteres) |
agentId | no | Agente que responde (modo AGENT) |
delete-dm-automation-rule
EXCLUI em definitivo uma automação de DM do workspace (não dá para desfazer). Para só pausar, use update-dm-automation-rule com active=false.
| Parameter | Required | Description |
|---|---|---|
ruleId | yes | ID da automação de DM (veja list-dm-automation-rules) |
get-dm-automation-rule
Detalhe de uma automação de DM do workspace: palavras-chave, escopo, modo, mensagem/agente e status.
| Parameter | Required | Description |
|---|---|---|
ruleId | yes | ID da automação de DM (veja list-dm-automation-rules) |
get-instagram-connection
Detalhe de uma conta do Instagram do workspace: perfil (nome, bio, site), agente e status.
| Parameter | Required | Description |
|---|---|---|
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
get-instagram-messaging-profile
Ice Breakers (perguntas iniciais) e menu persistente da DM da conta, como estão na Meta.
| Parameter | Required | Description |
|---|---|---|
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
list-dm-automation-rules
Lista as automações de DM do workspace: palavras-chave em comentários do Instagram que disparam uma DM (mensagem fixa ou agente), escopo (qualquer post ou um post) e se estão ativas.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | no | Opcional: só as automações desta conta do Instagram |
list-instagram-connections
Lista as contas do Instagram ativas do workspace: usuário, nome, bio e site (com os valores originais do Instagram), agente vinculado e acesso a mensagens.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
set-instagram-post-comments
Liga ou desliga os comentários de um post da conta do Instagram (vale direto no Instagram).
| Parameter | Required | Description |
|---|---|---|
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
mediaId | yes | ID numérico do post (mídia) no Instagram |
enabled | yes | true = comentários ligados; false = desligados |
update-dm-automation-rule
Edita uma automação de DM do workspace: palavras-chave (substitui a lista), escopo/post, modo (FIXED/AGENT), mensagem, agente ou liga/desliga (active). Só os campos enviados mudam.
| Parameter | Required | Description |
|---|---|---|
ruleId | yes | ID da automação de DM (veja list-dm-automation-rules) |
keywords | no | Lista completa de palavras-chave (substitui a atual) |
scope | no | — |
postId | no | — |
mode | no | — |
agentId | no | Agente que responde (modo AGENT) |
replyMessage | no | — |
active | no | true = ativa; false = pausada |
update-instagram-messaging-profile
SUBSTITUI os Ice Breakers (até 4 perguntas iniciais) e o menu persistente (até 5 botões) da DM na conta do Instagram. O que não for enviado é apagado: lista vazia remove tudo. Leia antes com get-instagram-messaging-profile. Botão "postback" vira DM com o texto do botão; "web_url" abre um link https.
| Parameter | Required | Description |
|---|---|---|
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
iceBreakers | yes | Lista completa de perguntas iniciais (substitui as atuais) |
persistentMenu | yes | Lista completa de botões do menu (substitui os atuais) |
update-instagram-profile
Edita nome, bio e site da conta do Instagram na XBASE (o que agentes e telas usam). A Meta não deixa alterar o perfil real do Instagram. Só os campos enviados mudam; null volta ao valor do Instagram.
| Parameter | Required | Description |
|---|---|---|
connectionId | yes | ID da conta do Instagram conectada (veja list-instagram-connections) |
name | no | Nome exibido (até 64). null = volta ao do Instagram |
biography | no | Bio (até 1000). null = volta à do Instagram |
website | no | Site (http:// ou https://, até 300). null = volta ao do Instagram |