# Ferramentas

> As 188 ferramentas do servidor MCP da Memberfy, organizadas por assunto (comunidade, conteúdo, cursos, eventos, membros, vendas, assinaturas, financeiro, certificados, chamada de trabalhos e relatórios), com o papel mínimo e o tipo de cada uma, e as regras comuns a todas.

O servidor MCP da Memberfy tem **188 ferramentas**, que cobrem todos os módulos da comunidade: o assistente faz o que o app deixa a pessoa conectada fazer, com o papel dela. O assistente escolhe sozinho qual usar a partir do seu pedido; esta página e as de cada assunto servem para você saber o que ele consegue fazer, com que papel, e como pedir. Os nomes estão em inglês, como o assistente os vê, e são os mesmos em qualquer idioma; o título que aparece no Claude ou no ChatGPT vem no idioma de quem conectou.

## Por assunto

| Assunto | O que dá para fazer | Ferramentas |
|---|---|---|
| [Comunidade e estrutura](/mcp/ferramentas-comunidade) | O contexto da conexão, abrir um link do app, criar, editar, reordenar e excluir seções e espaços, quem vê cada um, configurações e idioma, avisos de venda | 16 |
| [Conteúdo e engajamento](/mcp/ferramentas-conteudo) | Posts e posts curtos, mover um post, comentários, reações, fixar, busca, galeria, ranking e moderação | 24 |
| [Cursos](/mcp/ferramentas-cursos) | Cursos inteiros, capa, status, módulos e aulas (criar, editar, mover, excluir), matrícula e progresso | 13 |
| [Eventos](/mcp/ferramentas-eventos) | Eventos, ingressos, presença, transmissão ao vivo, banner e exclusão | 8 |
| [Membros](/mcp/ferramentas-membros) | Listar, convidar, trocar papéis, remover, grupos, tags e organograma | 16 |
| [Vendas e planos](/mcp/ferramentas-vendas) | Planos, opções, adicionais, produtos, preços, cupons, downsell e loja, em rascunho até a aprovação | 24 |
| [Assinaturas](/mcp/ferramentas-assinaturas) | Quem assina o quê, CSV, cortesias, descontos, extensões e cancelamentos; as suas assinaturas e compras, e mudar o seu plano | 13 |
| [Financeiro](/mcp/ferramentas-financeiro) | Vendas, clientes, extrato, saldo, saques e taxa | 8 |
| [Certificados](/mcp/ferramentas-certificados) | Modelos, quem emite, emissão, reenvio, revogação e reemissão; os seus certificados | 16 |
| [Chamada de trabalhos](/mcp/ferramentas-chamada) | O ciclo inteiro: abrir a chamada, trilhas e dias, donos e avaliadores, propostas, notas, decisão, negociação, agenda e votação | 40 |
| [Relatórios e gráficos](/mcp/relatorios-e-graficos) | Vendas, MRR, membros ativos, engajamento e ranking, eventos, cursos, a atividade de um membro e o painel do mês, prontos para virar gráfico | 8 |

Cada ferramenta tem um selo: <span class="tool-kind tool-kind-read">Só consulta</span> não muda nada, <span class="tool-kind tool-kind-write">Altera</span> cria ou muda algo na hora, e <span class="tool-kind tool-kind-confirm">Pede confirmação</span> só age depois do seu sim a um resumo.

## Todas as ferramentas

**Papel mínimo**: o menor papel com que a ferramenta aparece. "Qualquer" inclui o membro. O financeiro está listado à parte porque não entra na escada dos outros papéis.

| Ferramenta | Assunto | Papel mínimo | Tipo | O que faz |
|---|---|---|---|---|
| [`get_community_context`](/mcp/ferramentas-comunidade#get-community-context) | Comunidade e estrutura | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Comunidade, papel, seções e espaços com ids: o ponto de partida |
| [`get_connection_diagnostics`](/mcp/ferramentas-comunidade#get-connection-diagnostics) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Se a lista de ferramentas do assistente está em dia |
| [`list_spaces`](/mcp/ferramentas-comunidade#list-spaces) | Comunidade e estrutura | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Seções e espaços, com filtro por módulo |
| [`open_link`](/mcp/ferramentas-comunidade#open-link) | Comunidade e estrutura | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Diz o que é um link copiado do app (ou um id) |
| [`create_section`](/mcp/ferramentas-comunidade#create-section) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Cria uma seção do menu |
| [`create_space`](/mcp/ferramentas-comunidade#create-space) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Cria um espaço numa seção, com ícone |
| [`update_space`](/mcp/ferramentas-comunidade#update-space) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda nome, descrição, ícone ou visibilidade de um espaço, ou move para outra seção |
| [`update_section`](/mcp/ferramentas-comunidade#update-section) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda nome, descrição, ícone de uma seção, ou a torna a inicial |
| [`reorder_sections`](/mcp/ferramentas-comunidade#reorder-sections) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Põe as seções do menu numa nova ordem |
| [`reorder_spaces`](/mcp/ferramentas-comunidade#reorder-spaces) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Põe os espaços de uma seção numa nova ordem |
| [`update_space_access`](/mcp/ferramentas-comunidade#update-space-access) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Quem vê um espaço ou uma seção, e quem posta no espaço |
| [`delete_section`](/mcp/ferramentas-comunidade#delete-section) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui uma seção e os espaços dela |
| [`delete_space`](/mcp/ferramentas-comunidade#delete-space) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um espaço |
| [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | As configurações da comunidade: nome, cores, imagens, SEO, idioma, entrada |
| [`update_community_settings`](/mcp/ferramentas-comunidade#update-community-settings) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda nome, cores, logo, favicon, SEO, idioma e regras de entrada |
| [`get_notification_settings`](/mcp/ferramentas-comunidade#get-notification-settings) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | O e-mail que recebe os avisos de venda |
| [`update_notification_settings`](/mcp/ferramentas-comunidade#update-notification-settings) | Comunidade e estrutura | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda ou desliga o e-mail dos avisos de venda |
| [`list_posts`](/mcp/ferramentas-conteudo#list-posts) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | O feed, com comentários e reações |
| [`search_content`](/mcp/ferramentas-conteudo#search-content) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Procura posts, eventos, cursos, seções, espaços e chamadas pelo título |
| [`list_comments`](/mcp/ferramentas-conteudo#list-comments) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Comentários de um post |
| [`create_post`](/mcp/ferramentas-conteudo#create-post) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Publica um post, com capa por link |
| [`update_post`](/mcp/ferramentas-conteudo#update-post) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-write">Altera</span> | Edita título, texto, capa; fixa |
| [`delete_post`](/mcp/ferramentas-conteudo#delete-post) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um post, com confirmação |
| [`move_post`](/mcp/ferramentas-conteudo#move-post) | Conteúdo e engajamento | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Move um post para outro espaço de Conteúdo ou Feed |
| [`create_short_post`](/mcp/ferramentas-conteudo#create-short-post) | Conteúdo e engajamento | Membro (não o financeiro) | <span class="tool-kind tool-kind-write">Altera</span> | Publica um post curto, sem título, num Feed |
| [`create_comment`](/mcp/ferramentas-conteudo#create-comment) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Comenta ou responde |
| [`update_comment`](/mcp/ferramentas-conteudo#update-comment) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-write">Altera</span> | Edita um comentário |
| [`delete_comment`](/mcp/ferramentas-conteudo#delete-comment) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um comentário, com confirmação |
| [`add_reaction`](/mcp/ferramentas-conteudo#add-reaction) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Reage com um emoji |
| [`pin_post`](/mcp/ferramentas-conteudo#pin-post) | Conteúdo e engajamento | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Fixa ou desafixa no feed |
| [`add_gallery_image`](/mcp/ferramentas-conteudo#add-gallery-image) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Põe uma imagem, por link, numa galeria |
| [`list_gallery_images`](/mcp/ferramentas-conteudo#list-gallery-images) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | As imagens de uma galeria, com autor e reações |
| [`update_gallery_image`](/mcp/ferramentas-conteudo#update-gallery-image) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-write">Altera</span> | Muda o título ou a descrição de uma imagem |
| [`react_to_gallery_image`](/mcp/ferramentas-conteudo#react-to-gallery-image) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Reage a uma imagem da galeria |
| [`delete_gallery_image`](/mcp/ferramentas-conteudo#delete-gallery-image) | Conteúdo e engajamento | Autor ou moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui uma imagem da galeria |
| [`get_leaderboard`](/mcp/ferramentas-conteudo#get-leaderboard) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | O topo do ranking |
| [`get_my_points`](/mcp/ferramentas-conteudo#get-my-points) | Conteúdo e engajamento | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Os seus pontos e a sua posição no ranking |
| [`get_ranking_rules`](/mcp/ferramentas-conteudo#get-ranking-rules) | Conteúdo e engajamento | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Se o ranking está ligado e os pontos por ação |
| [`update_ranking_rules`](/mcp/ferramentas-conteudo#update-ranking-rules) | Conteúdo e engajamento | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Liga, desliga e muda os pontos |
| [`list_moderation_queue`](/mcp/ferramentas-conteudo#list-moderation-queue) | Conteúdo e engajamento | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | O que espera aprovação |
| [`moderate_item`](/mcp/ferramentas-conteudo#moderate-item) | Conteúdo e engajamento | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Aprova ou recusa um item da fila |
| [`list_courses`](/mcp/ferramentas-cursos#list-courses) | Cursos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Cursos da comunidade |
| [`get_course`](/mcp/ferramentas-cursos#get-course) | Cursos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Um curso com módulos e aulas |
| [`create_course`](/mcp/ferramentas-cursos#create-course) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Espaço, curso, módulos, aulas e o produto, de uma vez |
| [`update_course`](/mcp/ferramentas-cursos#update-course) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Edita um curso, a capa e o status |
| [`create_course_module`](/mcp/ferramentas-cursos#create-course-module) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Acrescenta um módulo a um curso |
| [`create_lesson`](/mcp/ferramentas-cursos#create-lesson) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Acrescenta uma aula a um módulo |
| [`update_course_module`](/mcp/ferramentas-cursos#update-course-module) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Renomeia um módulo ou muda a posição |
| [`update_lesson`](/mcp/ferramentas-cursos#update-lesson) | Cursos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda uma aula, ou a leva para outro módulo |
| [`delete_course_module`](/mcp/ferramentas-cursos#delete-course-module) | Cursos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um módulo com as aulas |
| [`delete_lesson`](/mcp/ferramentas-cursos#delete-lesson) | Cursos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui uma aula |
| [`delete_course`](/mcp/ferramentas-cursos#delete-course) | Cursos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um curso |
| [`enroll_in_course`](/mcp/ferramentas-cursos#enroll-in-course) | Cursos | Membro (não o financeiro) | <span class="tool-kind tool-kind-write">Altera</span> | Matricula você num curso publicado |
| [`complete_lesson`](/mcp/ferramentas-cursos#complete-lesson) | Cursos | Membro (não o financeiro) | <span class="tool-kind tool-kind-write">Altera</span> | Registra o seu progresso numa aula |
| [`list_events`](/mcp/ferramentas-eventos#list-events) | Eventos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Eventos próximos, passados, os meus ou todos |
| [`list_event_attendees`](/mcp/ferramentas-eventos#list-event-attendees) | Eventos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem confirmou presença num evento |
| [`create_event`](/mcp/ferramentas-eventos#create-event) | Eventos | Moderador (com ingresso, administrador) | <span class="tool-kind tool-kind-write">Altera</span> | Espaço, evento e o ingresso, de uma vez |
| [`update_event`](/mcp/ferramentas-eventos#update-event) | Eventos | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Edita um evento e o banner |
| [`start_live_stream`](/mcp/ferramentas-eventos#start-live-stream) | Eventos | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Marca o evento como ao vivo, com o link da transmissão |
| [`stop_live_stream`](/mcp/ferramentas-eventos#stop-live-stream) | Eventos | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Encerra a transmissão |
| [`rsvp_event`](/mcp/ferramentas-eventos#rsvp-event) | Eventos | Membro (não o financeiro) | <span class="tool-kind tool-kind-write">Altera</span> | Diz se você vai: vou, talvez ou não vou |
| [`delete_event`](/mcp/ferramentas-eventos#delete-event) | Eventos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um evento |
| [`list_members`](/mcp/ferramentas-membros#list-members) | Membros | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Membros com papel e data de entrada |
| [`invite_member`](/mcp/ferramentas-membros#invite-member) | Membros | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Convida uma pessoa, com papel, grupos e tags |
| [`invite_members`](/mcp/ferramentas-membros#invite-members) | Membros | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Convida até 100 pessoas de uma vez, com o resultado linha a linha |
| [`update_member_role`](/mcp/ferramentas-membros#update-member-role) | Membros | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Troca o papel de um membro |
| [`remove_member`](/mcp/ferramentas-membros#remove-member) | Membros | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira uma pessoa da comunidade |
| [`list_groups`](/mcp/ferramentas-membros#list-groups) | Membros | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Grupos, com cor, líder, grupo pai e quantas pessoas |
| [`create_group`](/mcp/ferramentas-membros#create-group) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Cria um grupo de membros |
| [`update_group`](/mcp/ferramentas-membros#update-group) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Renomeia ou muda um grupo |
| [`delete_group`](/mcp/ferramentas-membros#delete-group) | Membros | Moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um grupo; as pessoas ficam na comunidade |
| [`update_group_members`](/mcp/ferramentas-membros#update-group-members) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Põe ou tira pessoas de um grupo |
| [`list_tags`](/mcp/ferramentas-membros#list-tags) | Membros | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Tags usadas, com cor e quantas pessoas |
| [`update_member_tags`](/mcp/ferramentas-membros#update-member-tags) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Marca ou desmarca tags em uma ou mais pessoas |
| [`update_tag`](/mcp/ferramentas-membros#update-tag) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Renomeia ou muda a cor de uma tag |
| [`delete_tag`](/mcp/ferramentas-membros#delete-tag) | Membros | Moderador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira uma tag de todas as pessoas |
| [`get_org_chart`](/mcp/ferramentas-membros#get-org-chart) | Membros | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem responde a quem, com os grupos |
| [`set_manager`](/mcp/ferramentas-membros#set-manager) | Membros | Moderador | <span class="tool-kind tool-kind-write">Altera</span> | Diz a quem uma pessoa responde |
| [`list_activity_logs`](/mcp/ferramentas-membros#list-activity-logs) | Membros | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem fez o quê: equipe, assistente e membros |
| [`list_plans`](/mcp/ferramentas-vendas#list-plans) | Vendas e planos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Planos, opções e adicionais |
| [`list_products`](/mcp/ferramentas-vendas#list-products) | Vendas e planos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Opções de cobrança e produtos, com preço e status |
| [`list_coupons`](/mcp/ferramentas-vendas#list-coupons) | Vendas e planos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Cupons com status e uso |
| [`create_product`](/mcp/ferramentas-vendas#create-product) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Cria um produto ou opção de cobrança, em rascunho |
| [`create_plan`](/mcp/ferramentas-vendas#create-plan) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Opções, plano e adicionais, de uma vez |
| [`publish_product`](/mcp/ferramentas-vendas#publish-product) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Põe um produto à venda |
| [`unpublish_product`](/mcp/ferramentas-vendas#unpublish-product) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Tira um produto da venda |
| [`update_price`](/mcp/ferramentas-vendas#update-price) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Muda um preço, com confirmação |
| [`create_coupon`](/mcp/ferramentas-vendas#create-coupon) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cria um cupom, com confirmação |
| [`update_plan`](/mcp/ferramentas-vendas#update-plan) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda nome, endereço, opções e adicionais de um plano |
| [`update_product`](/mcp/ferramentas-vendas#update-product) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda título, espaços, estoque, parcelas, teste e link direto |
| [`update_coupon_status`](/mcp/ferramentas-vendas#update-coupon-status) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Pausa ou reativa um cupom |
| [`update_coupon`](/mcp/ferramentas-vendas#update-coupon) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Muda nome, desconto, duração, limites, validade e produtos de um cupom |
| [`delete_coupon`](/mcp/ferramentas-vendas#delete-coupon) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um cupom |
| [`get_coupon_usage`](/mcp/ferramentas-vendas#get-coupon-usage) | Vendas e planos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem usou um cupom |
| [`list_downsell_offers`](/mcp/ferramentas-vendas#list-downsell-offers) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | As ofertas de última chance de um plano, com conversão |
| [`create_downsell_offer`](/mcp/ferramentas-vendas#create-downsell-offer) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cria uma oferta de última chance |
| [`update_downsell_offer`](/mcp/ferramentas-vendas#update-downsell-offer) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Muda ou pausa uma oferta de última chance |
| [`delete_downsell_offer`](/mcp/ferramentas-vendas#delete-downsell-offer) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui uma oferta de última chance |
| [`delete_product`](/mcp/ferramentas-vendas#delete-product) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um produto ou opção de cobrança |
| [`delete_plan`](/mcp/ferramentas-vendas#delete-plan) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um plano |
| [`reorder_plans`](/mcp/ferramentas-vendas#reorder-plans) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Põe os planos numa nova ordem na página de preços |
| [`get_storefront`](/mcp/ferramentas-vendas#get-storefront) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | O que um espaço de Loja mostra |
| [`update_storefront`](/mcp/ferramentas-vendas#update-storefront) | Vendas e planos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Escolhe os produtos de uma Loja |
| [`list_subscriptions`](/mcp/ferramentas-assinaturas#list-subscriptions) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Assinaturas com status, valor e próxima cobrança |
| [`cancel_subscription`](/mcp/ferramentas-assinaturas#cancel-subscription) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cancela a assinatura de um membro, com confirmação |
| [`get_subscription`](/mcp/ferramentas-assinaturas#get-subscription) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Uma assinatura, com cobranças e próxima cobrança |
| [`create_manual_subscription`](/mcp/ferramentas-assinaturas#create-manual-subscription) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cortesia ou cobrança futura, sem checkout |
| [`update_subscription`](/mcp/ferramentas-assinaturas#update-subscription) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Desconto, estender, adicionais, reativar, link de pagamento |
| [`export_subscriptions_csv`](/mcp/ferramentas-assinaturas#export-subscriptions-csv) | Assinaturas | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | As assinaturas em CSV, com os mesmos filtros |
| [`list_my_subscriptions`](/mcp/ferramentas-assinaturas#list-my-subscriptions) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | As suas assinaturas |
| [`list_my_purchases`](/mcp/ferramentas-assinaturas#list-my-purchases) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | As suas compras avulsas |
| [`manage_my_subscription`](/mcp/ferramentas-assinaturas#manage-my-subscription) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cancela, pausa, retoma ou reativa a sua assinatura |
| [`quote_plan_change`](/mcp/ferramentas-assinaturas#quote-plan-change) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Quanto custa e o que muda ao passar para outro plano |
| [`change_my_plan`](/mcp/ferramentas-assinaturas#change-my-plan) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Muda o seu plano: agora, cobrando a diferença no cartão salvo, ou no fim do período |
| [`get_scheduled_plan_change`](/mcp/ferramentas-assinaturas#get-scheduled-plan-change) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | A mudança de plano agendada para o fim do período |
| [`cancel_scheduled_plan_change`](/mcp/ferramentas-assinaturas#cancel-scheduled-plan-change) | Assinaturas | Qualquer | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Desfaz a mudança de plano agendada |
| [`get_sales_summary`](/mcp/ferramentas-financeiro#get-sales-summary) | Financeiro | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Receita, série mensal, receita por produto e assinantes |
| [`list_customers`](/mcp/ferramentas-financeiro#list-customers) | Financeiro | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem paga e quanto já pagou |
| [`list_ledger_entries`](/mcp/ferramentas-financeiro#list-ledger-entries) | Financeiro | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Lançamentos do extrato |
| [`get_balance`](/mcp/ferramentas-financeiro#get-balance) | Financeiro | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Saldo total, disponível, retido e a liberar |
| [`list_payouts`](/mcp/ferramentas-financeiro#list-payouts) | Financeiro | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Saques e status |
| [`simulate_fee`](/mcp/ferramentas-financeiro#simulate-fee) | Financeiro | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Quanto a comunidade recebe de uma venda |
| [`request_payout`](/mcp/ferramentas-financeiro#request-payout) | Financeiro | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Pede um saque, com confirmação |
| [`cancel_payout`](/mcp/ferramentas-financeiro#cancel-payout) | Financeiro | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Cancela um saque pendente, com confirmação |
| [`list_certificate_templates`](/mcp/ferramentas-certificados#list-certificate-templates) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Modelos de um espaço de Certificados |
| [`get_certificate_template`](/mcp/ferramentas-certificados#get-certificate-template) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Um modelo, com a pré-visualização como imagem |
| [`create_certificate_template`](/mcp/ferramentas-certificados#create-certificate-template) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Cria um modelo, do padrão da plataforma ou com a arte da marca |
| [`update_certificate_template`](/mcp/ferramentas-certificados#update-certificate-template) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda textos, assinantes, caixas e a arte |
| [`activate_certificate_template`](/mcp/ferramentas-certificados#activate-certificate-template) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Ativa ou arquiva um modelo |
| [`issue_certificate`](/mcp/ferramentas-certificados#issue-certificate) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Emite para pessoas, grupos e tags, depois de um ensaio |
| [`list_issued_certificates`](/mcp/ferramentas-certificados#list-issued-certificates) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | Os emitidos, com status e busca |
| [`revoke_certificate`](/mcp/ferramentas-certificados#revoke-certificate) | Certificados | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Revoga um certificado |
| [`reissue_certificate`](/mcp/ferramentas-certificados#reissue-certificate) | Certificados | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Emite de novo com o nome atual |
| [`delete_certificate`](/mcp/ferramentas-certificados#delete-certificate) | Certificados | Administrador | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui um revogado ou que falhou |
| [`duplicate_certificate_template`](/mcp/ferramentas-certificados#duplicate-certificate-template) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Copia um modelo como rascunho novo |
| [`update_certificate_space_settings`](/mcp/ferramentas-certificados#update-certificate-space-settings) | Certificados | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Quem emite no espaço: a equipe ou só os administradores |
| [`resend_certificate_email`](/mcp/ferramentas-certificados#resend-certificate-email) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Manda de novo o e-mail do certificado |
| [`retry_certificate`](/mcp/ferramentas-certificados#retry-certificate) | Certificados | Moderador ou administrador | <span class="tool-kind tool-kind-write">Altera</span> | Refaz um certificado que falhou |
| [`list_my_certificates`](/mcp/ferramentas-certificados#list-my-certificates) | Certificados | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Os seus certificados, com código e links |
| [`set_certificate_indexing`](/mcp/ferramentas-certificados#set-certificate-indexing) | Certificados | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Mostra ou esconde um certificado seu nos buscadores |
| [`list_calls_for_papers`](/mcp/ferramentas-chamada#list-calls-for-papers) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | As chamadas de um espaço, com status |
| [`get_call_space_settings`](/mcp/ferramentas-chamada#get-call-space-settings) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Como o espaço funciona: uma ou várias chamadas, quem abre |
| [`update_call_space_settings`](/mcp/ferramentas-chamada#update-call-space-settings) | Chamada de trabalhos | Administrador | <span class="tool-kind tool-kind-write">Altera</span> | Muda o modo do espaço e quem pode abrir chamada |
| [`get_call_for_papers`](/mcp/ferramentas-chamada#get-call-for-papers) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Uma chamada com datas, trilhas, dias, donos e o que você pode fazer |
| [`create_call_for_papers`](/mcp/ferramentas-chamada#create-call-for-papers) | Chamada de trabalhos | Quem pode abrir | <span class="tool-kind tool-kind-write">Altera</span> | Abre uma chamada em rascunho, com trilhas, dias e banner |
| [`update_call_for_papers`](/mcp/ferramentas-chamada#update-call-for-papers) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Edita texto, datas, formatos, custos, cachê e imagens |
| [`update_call_status`](/mcp/ferramentas-chamada#update-call-status) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Publica, despublica, encerra ou reabre |
| [`delete_call_for_papers`](/mcp/ferramentas-chamada#delete-call-for-papers) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Exclui a chamada, com trilhas e propostas |
| [`add_call_track`](/mcp/ferramentas-chamada#add-call-track) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Acrescenta uma trilha |
| [`update_call_track`](/mcp/ferramentas-chamada#update-call-track) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Renomeia uma trilha ou muda o propósito |
| [`delete_call_track`](/mcp/ferramentas-chamada#delete-call-track) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira uma trilha |
| [`add_call_event_date`](/mcp/ferramentas-chamada#add-call-event-date) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Acrescenta um dia ao evento |
| [`update_call_event_date`](/mcp/ferramentas-chamada#update-call-event-date) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Muda o horário de um dia |
| [`delete_call_event_date`](/mcp/ferramentas-chamada#delete-call-event-date) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira um dia do evento |
| [`add_call_owner`](/mcp/ferramentas-chamada#add-call-owner) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Convida alguém para ser dono da chamada |
| [`remove_call_owner`](/mcp/ferramentas-chamada#remove-call-owner) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira um dono |
| [`list_track_reviewers`](/mcp/ferramentas-chamada#list-track-reviewers) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> | Os avaliadores de uma trilha |
| [`invite_track_reviewer`](/mcp/ferramentas-chamada#invite-track-reviewer) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Põe alguém como avaliador de uma trilha |
| [`remove_track_reviewer`](/mcp/ferramentas-chamada#remove-track-reviewer) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Tira um avaliador |
| [`list_my_call_invitations`](/mcp/ferramentas-chamada#list-my-call-invitations) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | Os seus convites pendentes, para dono ou avaliador |
| [`respond_to_call_invitation`](/mcp/ferramentas-chamada#respond-to-call-invitation) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-write">Altera</span> | Aceita ou recusa um convite seu |
| [`list_speakers`](/mcp/ferramentas-chamada#list-speakers) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> | Quem já propôs na comunidade |
| [`invite_speaker`](/mcp/ferramentas-chamada#invite-speaker) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Convida alguém a propor |
| [`list_proposals`](/mcp/ferramentas-chamada#list-proposals) | Chamada de trabalhos | Conforme o papel na chamada | <span class="tool-kind tool-kind-read">Só consulta</span> | As propostas, com status, trilha e notas |
| [`get_proposal`](/mcp/ferramentas-chamada#get-proposal) | Chamada de trabalhos | Donos, avaliadores da trilha e quem propôs | <span class="tool-kind tool-kind-read">Só consulta</span> | Uma proposta, com as avaliações e a negociação |
| [`list_my_reviews`](/mcp/ferramentas-chamada#list-my-reviews) | Chamada de trabalhos | Avaliador | <span class="tool-kind tool-kind-read">Só consulta</span> | A sua fila de avaliação |
| [`review_proposal`](/mcp/ferramentas-chamada#review-proposal) | Chamada de trabalhos | Avaliador da trilha | <span class="tool-kind tool-kind-write">Altera</span> | Dá nota de 1 a 5 a uma proposta |
| [`get_review_progress`](/mcp/ferramentas-chamada#get-review-progress) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-read">Só consulta</span> | O andamento da avaliação, contra o mínimo |
| [`get_proposal_reviews`](/mcp/ferramentas-chamada#get-proposal-reviews) | Chamada de trabalhos | Donos; avaliadores depois de avaliar | <span class="tool-kind tool-kind-read">Só consulta</span> | As notas de uma proposta e o consenso |
| [`decide_proposal`](/mcp/ferramentas-chamada#decide-proposal) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Aceita ou recusa uma proposta |
| [`negotiate_proposal`](/mcp/ferramentas-chamada#negotiate-proposal) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Contraproposta, retirar, aceitar ou encerrar a negociação |
| [`confirm_proposal`](/mcp/ferramentas-chamada#confirm-proposal) | Chamada de trabalhos | Equipe ou dono | <span class="tool-kind tool-kind-write">Altera</span> | Confirma a proposta aceita na agenda |
| [`list_votable_proposals`](/mcp/ferramentas-chamada#list-votable-proposals) | Chamada de trabalhos | Quem pode votar | <span class="tool-kind tool-kind-read">Só consulta</span> | A cédula: o que você pode votar e o seu voto |
| [`vote_on_proposal`](/mcp/ferramentas-chamada#vote-on-proposal) | Chamada de trabalhos | Quem pode votar | <span class="tool-kind tool-kind-write">Altera</span> | Vota de 1 a 5, ou tira o voto |
| [`get_vote_results`](/mcp/ferramentas-chamada#get-vote-results) | Chamada de trabalhos | Conforme a chamada | <span class="tool-kind tool-kind-read">Só consulta</span> | O resultado, até onde a chamada mostra |
| [`list_my_proposals`](/mcp/ferramentas-chamada#list-my-proposals) | Chamada de trabalhos | Qualquer | <span class="tool-kind tool-kind-read">Só consulta</span> | As suas propostas, com status |
| [`submit_proposal`](/mcp/ferramentas-chamada#submit-proposal) | Chamada de trabalhos | Qualquer membro | <span class="tool-kind tool-kind-write">Altera</span> | Envia uma proposta a uma chamada aberta |
| [`update_proposal`](/mcp/ferramentas-chamada#update-proposal) | Chamada de trabalhos | Quem propôs | <span class="tool-kind tool-kind-write">Altera</span> | Edita a proposta em rascunho e envia |
| [`withdraw_proposal`](/mcp/ferramentas-chamada#withdraw-proposal) | Chamada de trabalhos | Quem propôs | <span class="tool-kind tool-kind-confirm">Pede confirmação</span> | Retira a proposta da chamada |
| [`respond_to_counter_offer`](/mcp/ferramentas-chamada#respond-to-counter-offer) | Chamada de trabalhos | Quem propôs | <span class="tool-kind tool-kind-write">Altera</span> | Aceita a contraproposta ou responde com outra |
| [`sales_report`](/mcp/relatorios-e-graficos#sales-report) | Relatórios e gráficos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Vendas por dia, semana ou mês, por plano, produto ou forma de pagamento, e o total desde a primeira venda |
| [`subscriptions_report`](/mcp/relatorios-e-graficos#subscriptions-report) | Relatórios e gráficos | Administrador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | MRR, assinaturas novas e canceladas, churn, cortesias e downsell |
| [`members_report`](/mcp/relatorios-e-graficos#members-report) | Relatórios e gráficos | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Membros novos, ativos e inativos, por grupo e por tag |
| [`engagement_report`](/mcp/relatorios-e-graficos#engagement-report) | Relatórios e gráficos | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Posts, comentários, reações, quem mais engaja, posts sem resposta e os pontos do ranking |
| [`events_report`](/mcp/relatorios-e-graficos#events-report) | Relatórios e gráficos | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Eventos e quantos responderam vou, talvez e não vou |
| [`courses_report`](/mcp/relatorios-e-graficos#courses-report) | Relatórios e gráficos | Moderador | <span class="tool-kind tool-kind-read">Só consulta</span> | Matrículas, conclusões e progresso por curso |
| [`member_activity`](/mcp/relatorios-e-graficos#member-activity) | Relatórios e gráficos | Administrador | <span class="tool-kind tool-kind-read">Só consulta</span> | O que uma pessoa fez: contagens, pontos do ranking e links |
| [`community_overview`](/mcp/relatorios-e-graficos#community-overview) | Relatórios e gráficos | Moderador ou financeiro | <span class="tool-kind tool-kind-read">Só consulta</span> | Este mês contra o mês passado, num pedido só |

## Quantas cada papel vê

| Papel | Ferramentas |
|---|---|
| **Proprietário** e **administrador** | As 188 |
| **Moderador** | 111: as 40 da chamada de trabalhos, a leitura aberta a todos, posts e posts curtos (inclusive mover e fixar), comentários, reações e galeria, a moderação, `create_event`, `update_event` e a transmissão ao vivo, `list_members` e as 11 de grupos, tags e organograma, os modelos, a emissão, o reenvio e o refazer de certificados (conforme **Quem emite** no espaço), as próprias matrículas, presença, pontos, assinaturas, compras e certificados, e os relatórios de membros, engajamento, eventos e cursos e o `community_overview` |
| **Financeiro** | 90: as 40 da chamada de trabalhos, a leitura aberta a todos, posts, comentários, reações e galeria, a leitura de planos, produtos e cupons, as 9 de leitura financeira, as assinaturas da comunidade (listar, ver, exportar, cortesia, ações e cancelar), as próprias assinaturas, compras, pontos e certificados, e os relatórios de vendas e de assinaturas e o `community_overview` |
| **Membro** | 76: as 40 da chamada de trabalhos, a leitura aberta a todos, posts e posts curtos, comentários, reações e galeria (editar e excluir só o que é seu), matrícula e progresso nos cursos, presença em eventos, e as próprias assinaturas, compras, pontos e certificados |

As 40 da chamada de trabalhos aparecem para todos porque o dono de uma chamada pode ser um membro comum, e qualquer membro propõe, avalia ou vota quando a chamada deixa. A Memberfy confere cada chamada pela regra do módulo. Ver [Chamada de trabalhos](/mcp/ferramentas-chamada#quem-usa-o-que).

Uma conexão autorizada só para leitura vê só as ferramentas de leitura do papel.

Ver uma ferramenta na lista não garante que toda chamada passe: a Memberfy confere cada ação como se fosse feita na tela. Um membro vê `create_post`, mas publicar num espaço com **Quem pode postar = Equipe** é recusado. Ver [Papéis e permissões](/conceitos/papeis-e-permissoes).

## Regras comuns

### Os ids

As ferramentas falam por **ids**, e onde pedem um id aceitam também o link copiado do app (ver [`open_link`](/mcp/ferramentas-comunidade#open-link)). Quase todas as conversas começam por `get_community_context`, que devolve as seções e os espaços com os ids; as listagens devolvem os ids do que listam. A descrição de cada ferramenta diz de onde vem cada id, e o assistente encadeia sozinho: você pede *"publique no espaço Avisos"*, ele procura o id do espaço *Avisos* e publica.

### Paginação

As listagens aceitam `page` (a página, começando em 1) e `limit` (quantos por página). A resposta traz os itens e o total, para o assistente saber se precisa pedir a próxima página.

### Rascunho primeiro

Tudo o que se vende nasce em **rascunho**: `create_product`, o produto do `create_course`, o ingresso do `create_event` e as opções do `create_plan`. Nada vai para a venda sem `publish_product` (ou `publish: true` na composta). Assim você revisa antes.

Criar não depende da [informação comercial](/pagamentos/informacao-comercial) aprovada; publicar, sim. Numa comunidade sem aprovação, a composta que pediu para publicar **não desfaz nada**: o curso, o evento ou o plano fica em rascunho, a resposta traz o motivo em `publish_blocked`, e o próximo passo sugerido é preencher a informação comercial e publicar depois. Ver [Rascunho antes da aprovação](/mcp/ferramentas-vendas#rascunho-antes-da-aprovacao).

### Idempotência nas compostas

As três compostas aceitam `idempotency_key` (até 100 caracteres). Repetir a chamada com a mesma chave devolve o resultado da primeira, sem criar de novo. Serve para quando a conexão cai no meio e o assistente não sabe se a chamada passou.

### Desfazer quando um passo falha

As compostas criam em ordem e, se um passo falha, apagam o que já tinham criado (menos quando o que falhou foi publicar sem a informação comercial aprovada: aí fica tudo em rascunho), do mais novo para o mais antigo, e dizem qual passo falhou: *"O passo "módulo 2" falhou e tudo o que esta chamada criou foi desfeito."* Se algo não puder ser desfeito, a resposta lista o que sobrou para você conferir no painel.

### Próximos passos

Quando cabe uma continuação, a resposta da ferramenta traz `next_steps`: até **três ações sugeridas**, cada uma com a ferramenta, o motivo (no idioma de quem conectou) e, às vezes, os argumentos já prontos. Elas dependem do que voltou e do seu papel: só entram ferramentas que você pode usar. O assistente oferece essas ações antes de sugerir qualquer outra coisa, e nenhuma acontece sem você pedir.

| Quando | O que a Memberfy sugere |
|---|---|
| Há propostas esperando decisão | Decidir cada uma (`decide_proposal`) |
| O relatório de engajamento mostra posts sem resposta | Responder a eles (`create_comment`) |
| Um post foi publicado sem capa | Gerar uma imagem e pôr de capa (`update_post`) |
| Um modelo de certificado acabou de ser criado | Conferir a pré-visualização e ajustar (`update_certificate_template`), depois ativar (`activate_certificate_template`) |
| Um relatório de vendas | O mesmo relatório no período anterior, para comparar (`sales_report`, com as datas prontas) |
| Itens esperando moderação | Aprovar ou recusar (`moderate_item`) |
| Assinaturas em atraso | Enviar o link de pagamento (`update_subscription`) |
| Saldo disponível | Pedir um saque (`request_payout`) |
| Um produto, curso ou ingresso criado em rascunho | Publicar (`publish_product`) |
| A publicação foi recusada por falta de informação comercial aprovada | Preencher **Configurações › Informação Comercial**, esperar a aprovação e publicar (`publish_product`) |
| Uma chamada de trabalhos criada sem trilhas, ou ainda em rascunho | Acrescentar trilhas (`add_call_track`), pôr avaliadores (`invite_track_reviewer`) e publicar (`update_call_status`) |
| Uma proposta aceita | Confirmar na agenda (`confirm_proposal`) |

### Erros

Quando a Memberfy recusa, o assistente recebe a mensagem dela, a mesma da tela:

| Situação | O que o assistente recebe |
|---|---|
| O papel não permite | *"Seu papel (moderator) não permite esta ação nesta comunidade."*, mais o motivo |
| Um dado inválido | *"A API recusou (400): …"*, com o campo e a mensagem |
| Muitas chamadas | *"Muitas chamadas em pouco tempo. Espere um minuto e tente de novo."* |

### Versão do servidor e da lista

Cada deploy da Memberfy muda a versão do servidor, e a lista de ferramentas que uma conexão recebe tem uma impressão digital própria. É assim que se sabe se um assistente está com a lista em dia.

| Onde | O que vem |
|---|---|
| `serverInfo.version`, no `initialize` | `<versão>+<commit>`, por exemplo `1.0.0+4a9b547`. Muda a cada deploy |
| `_meta.memberfy`, no `initialize` e no `tools/list` | `server_version`, `tools_fingerprint` (um código curto que muda quando muda um nome ou um esquema de entrada da lista que esta conexão recebe) e `tool_count` |
| As instruções do servidor | Terminam com uma linha que repete a versão da lista |

Chamar uma ferramenta que não está na lista da conexão devolve um erro de ferramenta (`isError`) pedindo para a pessoa abrir uma conversa nova ou reconectar; se o nome é um dos antigos em português, a resposta traz `renamed_to` com o nome novo. A chamada fica na auditoria como `tool.unknown`.

O proprietário e os administradores comparam a última lista que uma conexão recebeu com a atual em [`GET /api/oauth/connections/{id}/diagnostics`](/api/referencia/mcp/get-oauth-connections-by-id-diagnostics): o campo `listUpToDate` diz se ela está em dia. Ver [Auditoria](/mcp/seguranca#auditoria).

### Pedem confirmação

Só pedem confirmação as ferramentas que **mexem em dinheiro** e as que **apagam** (as que começam com `delete_`, `remove_`, `revoke_`, `withdraw_` ou `cancel_`). Com o selo <span class="tool-kind tool-kind-confirm">Pede confirmação</span>, elas não agem na primeira chamada: devolvem um resumo e um código, e só agem quando o assistente repete a chamada com o código, depois do seu sim. Todas as outras, inclusive convites, troca de papel, configurações e emissão de certificados, rodam na primeira chamada. A tabela acima mostra o selo de cada uma. Ver [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao).

### Texto em Markdown

O assistente escreve e lê o texto da Memberfy em **Markdown**. A Memberfy converte para o texto formatado do app na ida, e de volta para Markdown na volta: o post aparece no app com negrito e lista, e não com asteriscos.

| Campo | O que aceita |
|---|---|
| O texto de um post (`create_post`, `update_post`), a descrição de um evento (`create_event`, `update_event`), o texto da chamada de trabalhos (`create_call_for_papers`, `update_call_for_papers`) e a descrição de uma proposta (`submit_proposal`, `update_proposal`) | Markdown completo: **negrito**, *itálico*, listas, links, intertítulos (o `#` vira intertítulo de nível 2; não há título de nível 1 dentro do texto), citação e código |
| O texto de um post curto (`create_short_post`, ou `update_post` com `type: status`) | Só negrito, itálico, links e quebras de linha |
| Títulos, nomes, comentários, e a descrição de curso, produto, plano, grupo, espaço e seção | Texto simples: as marcas de Markdown são tiradas, porque o app mostra esses campos sem formatação |

O que não passa para o app:

- **Imagem dentro do texto** vira um link para a imagem. Para a capa de um post ou o banner de um evento, use `image_url` (veja [Imagens](#imagens)).
- **Tabela** vira linhas de texto, uma por linha da tabela.
- Script, atributos de evento e links `javascript:` são removidos.

HTML pronto também é aceito e passa pelo mesmo filtro. Na leitura, as ferramentas devolvem o texto formatado em Markdown e marcam o resultado com `text_format: "markdown"`. Ler e gravar de novo o mesmo texto não muda nada.

### Imagens

`create_post`, `add_gallery_image`, `create_course`, `create_event`, `update_post`, `update_event` e `update_course` aceitam a imagem de dois jeitos:

- `image_url`: o link de uma imagem que está na internet. A Memberfy baixa e guarda como se você a tivesse enviado pelo painel.
- `image_base64` (com `image_type`, opcional): o arquivo em si, até 5 MB. É o caminho para uma imagem que o próprio assistente gerou na conversa. SVG é aceito e vira PNG; SVG que aponta para arquivos externos é recusado.

| Regra | |
|---|---|
| Endereço | Só `http` ou `https`, público. Endereços internos e privados são recusados, também depois de um redirecionamento |
| Formato | JPEG, PNG, WebP ou GIF, conferido pelo conteúdo do arquivo |
| Tamanho | Até 10 MB |
| Tempo | O download tem 10 segundos |

Um link de página (e não da imagem em si) é recusado com *"o arquivo não é uma imagem JPEG, PNG, WebP ou GIF"*.

Nas compostas, uma imagem ruim **não desfaz** o resto: o curso ou o evento é criado sem a capa, e a resposta traz o motivo em `warnings` (*"Não deu para usar a imagem de …: a imagem passa de 10 MB."*). Peça de novo com outro link, ou ponha a imagem pelo painel. Nas ferramentas de uma coisa só (`create_post`, `add_gallery_image`), a imagem ruim impede a criação.

## Relacionados

- [Receitas](/mcp/receitas)
- [Dinheiro e confirmação](/mcp/dinheiro-e-confirmacao)
- [Segurança e limites](/mcp/seguranca)