# Referência de ferramentas MCP

- [Referência de ferramentas MCP](https://sosoapi.ai/pt-br/docs/mcp): Encontre entradas, saídas, perfis e disponibilidade local ou hospedada das ferramentas.
- [Obter perfil do usuário](https://sosoapi.ai/pt-br/docs/mcp/get-user-profile): MCP: Obter perfil do usuário Consulte o próprio perfil do usuário conectado (nome de exibição, fuso, avatar, tema); profile é null até existir.
- [Atualizar perfil do usuário](https://sosoapi.ai/pt-br/docs/mcp/update-user-profile): MCP: Atualizar perfil do usuário. Altere o próprio perfil do usuário conectado (display_name, timezone, avatar_url, theme). Envie apenas os campos a alterar.
- [Assinar envio de avatar](https://sosoapi.ai/pt-br/docs/mcp/sign-avatar-upload): MCP: Assinar envio de avatar. Obtenha uma URL assinada para enviar uma nova imagem de avatar do usuário conectado (filename e content_type obrigatórios). Não altera o perfil por si só.
- [Listar API keys](https://sosoapi.ai/pt-br/docs/mcp/list-api-keys): MCP: Listar API keys. Liste as API keys do usuário (nome, últimos 4 caracteres, status, validade, linhagem); defina include_authority para obter também as capacidades e o limite de Workspace de cada chave. Segredos nunca são retornados. Exige a permissão de gerenciar API keys; um PAT não pode usá-la.
- [Criar API key](https://sosoapi.ai/pt-br/docs/mcp/create-api-key): MCP: Criar API key. Crie uma chave de acesso pessoal com as capacidades escolhidas (agent:operate, agent:publish, agent:engage), limite opcional de workspace_ids e duração de até 365 dias; o segredo é retornado uma vez e não pode ser consultado novamente. Um agente só pode conceder o que sua própria autorização permite, por no máximo 30 dias, e a chave para de funcionar quando essa concessão termina. Exige a permissão de gerenciar API keys; um PAT não pode usá-la.
- [Estender API key](https://sosoapi.ai/pt-br/docs/mcp/extend-api-key): MCP: Estender API key. Defina uma validade posterior (expires_at) para uma API key identificada por id: no máximo 365 dias a partir de agora, ou 30 para uma chave criada por agente. Um agente só pode estender chaves criadas pela sua própria concessão. Exige a permissão de gerenciar API keys.
- [Renovar API key](https://sosoapi.ai/pt-br/docs/mcp/renew-api-key): MCP: Renovar API key. Crie uma sucessora para uma API key (id) com um novo segredo retornado uma vez e as mesmas capacidades e limite de Workspace, opcionalmente com novo nome ou duração (no máximo 365 dias, 30 para chave criada por agente). A chave original não é revogada. Exige a permissão de gerenciar API keys.
- [Revogar API key](https://sosoapi.ai/pt-br/docs/mcp/revoke-api-key): MCP: Revogar API key Revogue uma API key por id para interromper seu funcionamento imediatamente; uma chave já revogada informa already_revoked. Um agente só pode revogar chaves criadas pela sua própria concessão. Exige a permissão de gerenciar API keys.
- [Obter status de cobrança](https://sosoapi.ai/pt-br/docs/mcp/get-billing-status): MCP: Obter status de cobrança. Consulte o plano de cobrança, o estado de pagamento, as datas do ciclo atual e o uso de cotas do usuário (publicações bem-sucedidas, posts agendados pendentes, contas conectadas). Confira antes de grandes execuções de agendamento.
- [Obter acesso comercial](https://sosoapi.ai/pt-br/docs/mcp/get-commercial-access): MCP: Obter acesso comercial. Consulte informações de plano e cotas da conta de cobrança de um Workspace, além de commercial_access_mode (off, shadow ou enforce).
- [Obter contexto da Organization](https://sosoapi.ai/pt-br/docs/mcp/get-organization-context): MCP: Obter contexto da Organization. Consulte o mapa atual de suas Organizations, seus Workspaces e Channels com ids e funções. Use quando precisar de ids de Organization ou Channel. Para publicar no Workspace, reutilize um id de Workspace retornado; não consulte também o contexto do workspace.
- [Criar Workspace](https://sosoapi.ai/pt-br/docs/mcp/create-workspace): MCP: Criar Workspace Crie um Workspace em uma Organization da qual você seja proprietário ou administrador. Informe organization_id quando participar de várias Organizations. Use o id retornado nas próximas chamadas: não presuma que o novo Workspace se torna ativo.
- [Obter contexto do Workspace](https://sosoapi.ai/pt-br/docs/mcp/get-workspace-context): MCP: Obter contexto do Workspace. Liste os Workspaces dos quais o usuário conectado participa e qual está ativo. Use quando workspace_id for desconhecido; reutilize o contexto atual em vez de repetir ambas as consultas de contexto. O Workspace ativo informado corresponde à seleção feita por uma pessoa no app web, não a um padrão para suas chamadas: informe workspace_id explicitamente. Não é uma operação apenas de leitura: para uma conta sem Workspace, ela cria o primeiro.
- [Atualizar Workspace](https://sosoapi.ai/pt-br/docs/mcp/update-workspace): MCP: Atualizar Workspace. Renomeie um Workspace ou altere seu slug. Somente o proprietário do Workspace.
- [Listar organizações](https://sosoapi.ai/pt-br/docs/mcp/list-organizations): MCP: Listar organizações. Liste as Organizations das quais o usuário conectado participa, com os ids que ferramentas de escopo de Organization recebem como organization_id.
- [Listar conexões da organização](https://sosoapi.ai/pt-br/docs/mcp/list-organization-connections): MCP: Listar conexões da organização. Liste as conexões de provedores de uma Organization (Meta, Instagram, Threads, YouTube) e seu status. Exige organization_id.
- [Revisar conexão da organização](https://sosoapi.ai/pt-br/docs/mcp/review-organization-connection): MCP: Revisar conexão da organização. Consulte as contas e páginas do provedor descobertas por uma operação de conexão pendente (operation_id) para revisão. Somente leitura: uma pessoa confirma a conexão no app web.
- [Listar canais da organização](https://sosoapi.ai/pt-br/docs/mcp/list-organization-channels): MCP: Listar canais da organização. Liste os canais de uma Organization (contas conectadas de provedores) e o Workspace ao qual cada um está associado.
- [Pré-visualizar movimentação de canal](https://sosoapi.ai/pt-br/docs/mcp/preview-organization-channel-move): MCP: Pré-visualizar movimentação de canal. Simulação: confira se um canal pode ser movido para outro Workspace e liste os impedimentos. Não altera nada.
- [Listar membros do Workspace](https://sosoapi.ai/pt-br/docs/mcp/list-workspace-members): MCP: Listar membros do Workspace. Liste os membros de um Workspace e os convites pendentes.
- [Enviar feedback](https://sosoapi.ai/pt-br/docs/mcp/submit-feedback): MCP: Enviar feedback. Envie feedback do produto (type bug, feature ou general; até 4,000 caracteres) à equipe SosoAPI em nome do usuário. Use somente quando o usuário solicitar.
- [Obter preferências de notificação](https://sosoapi.ai/pt-br/docs/mcp/get-notification-preferences): MCP: Obter preferências de notificação. Consulte as configurações de notificação do usuário (atualmente se um e-mail é enviado quando um post falha).
- [Atualizar preferências de notificação](https://sosoapi.ai/pt-br/docs/mcp/update-notification-preferences): MCP: Atualizar preferências de notificação. Altere as configurações de notificação do usuário (email_post_failed ativado ou desativado).
- [Listar notificações da caixa de entrada](https://sosoapi.ai/pt-br/docs/mcp/list-inbox-notifications): MCP: Listar notificações da caixa de entrada. Consulte a caixa de entrada do usuário no app, dos mais recentes para os mais antigos (até 50), opcionalmente apenas não lidos ou de um tipo.
- [Listar contas conectadas](https://sosoapi.ai/pt-br/docs/mcp/list-connected-accounts): MCP: Listar contas conectadas. Liste as contas sociais (Instagram, Threads, Facebook, YouTube) conectadas a um Workspace, com integridade da conexão e informações de capacidades. Use seus ids como social_account_id ao agendar ou comentar. Informe workspace_id: uma requisição sem ele é recusada quando o direcionamento explícito estiver em vigor.
- [Desconectar conta social](https://sosoapi.ai/pt-br/docs/mcp/disconnect-social-account): MCP: Desconectar conta social. Desconecte uma conta social do seu Workspace (somente o proprietário do Workspace). A publicação nessa conta é interrompida até que uma pessoa a reconecte com `sosoapi connect`.
- [Definir sincronização automática da conta social](https://sosoapi.ai/pt-br/docs/mcp/set-social-account-auto-sync): MCP: Definir sincronização automática da conta social. Ative ou desative a sincronização automática de uma conta social conectada (função editor). Não publica nada.
- [Remover bloqueio de conta social](https://sosoapi.ai/pt-br/docs/mcp/clear-social-account-block): MCP: Remover bloqueio de conta social. Remova o período de espera do provedor em uma conta para retomar a publicação. Isso não repete posts que falharam; use sosoapi_retry_scheduled_post para isso.
- [Consultar ativos](https://sosoapi.ai/pt-br/docs/mcp/query-assets): MCP: Consultar ativos. Encontre ativos de um Workspace por asset_type, source ou tag; retorna uma página (limit até 100, mais offset) e o total. Informe workspace_id explicitamente.
- [Obter ativo](https://sosoapi.ai/pt-br/docs/mcp/get-asset): MCP: Obter ativo. Consulte um ativo por id: metadados e uma URL de prévia de curta duração.
- [Criar ativo](https://sosoapi.ai/pt-br/docs/mcp/create-asset): MCP: Criar ativo. Registre um ativo de mídia ou texto que você já hospeda (asset_url, asset_type). Isso não envia nada: use sosoapi_upload_asset para um arquivo local ou sosoapi_import_asset_url para o SosoAPI buscar uma URL pública. Informe workspace_id (recusado sem ele quando o direcionamento explícito estiver em vigor). idempotency_key opcional.
- [Atualizar ativo](https://sosoapi.ai/pt-br/docs/mcp/update-asset): MCP: Atualizar ativo. Altere o título, a descrição ou as tags de um ativo (função editor).
- [Excluir ativo](https://sosoapi.ai/pt-br/docs/mcp/delete-asset): MCP: Excluir ativo Exclua um ativo da biblioteca do Workspace por id. Somente o proprietário do Workspace.
- [Listar ativos](https://sosoapi.ai/pt-br/docs/mcp/list-assets): MCP: Listar ativos Liste os ativos de um Workspace filtrados por kind (video, image, audio, cover, thumbnail, frame, video-source, branding) ou customer_ready_only, com paginação next_offset. workspace_id é obrigatório.
- [Importar URL de ativo](https://sosoapi.ai/pt-br/docs/mcp/import-asset-url): MCP: Importar URL de ativo. Peça ao SosoAPI para baixar uma imagem ou um vídeo de uma URL pública http(s) para o armazenamento privado do Workspace como novo ativo. Retorna import_id; consulte sosoapi_get_asset_import_status periodicamente. Exige idempotency_key e a função editor.
- [Obter status de importação de ativo](https://sosoapi.ai/pt-br/docs/mcp/get-asset-import-status): MCP: Obter status de importação de ativo. Consulte uma importação por import_id. Para publicar, informe include_asset=true: um resultado ready inclui o id, o tipo e a asset_url estável do ativo registrado, evitando um get_asset separado. Ativos pendentes ou ausentes não podem ser agendados. Nunca use a URL de origem ou prévia como identidade da mídia. Se travar, consulte sosoapi_job_status com job_id; nunca inicie uma importação duplicada.
- [Listar ativos órfãos](https://sosoapi.ai/pt-br/docs/mcp/list-orphan-assets): MCP: Listar ativos órfãos. Liste os objetos armazenados em um Workspace aos quais nenhum registro de ativo aponta (limpeza de armazenamento), com paginação por token de continuação. Somente o proprietário do Workspace.
- [Excluir ativos órfãos](https://sosoapi.ai/pt-br/docs/mcp/delete-orphan-assets): MCP: Excluir ativos órfãos. Exclua por chave os objetos de armazenamento não registrados selecionados. Somente o proprietário do Workspace; liste-os primeiro com sosoapi_list_orphan_assets.
- [Obter inventário de armazenamento de ativos](https://sosoapi.ai/pt-br/docs/mcp/get-asset-storage-inventory): MCP: Obter inventário de armazenamento de ativos. Consulte um inventário paginado dos ativos registrados e objetos armazenados de um Workspace para auditar o armazenamento.
- [Criar exportação de ativos](https://sosoapi.ai/pt-br/docs/mcp/create-asset-export): MCP: Criar exportação de ativos. Exporte os ativos selecionados (asset_ids) como manifesto. O modo export_verify_then_purge os prepara para uma exclusão definitiva posterior. idempotency_key opcional.
- [Verificar exportação de ativos](https://sosoapi.ai/pt-br/docs/mcp/verify-asset-export): MCP: Verificar exportação de ativos Inicie a verificação de uma exportação de ativos (export_id). Uma exportação deve ser verificada antes de solicitar exclusão definitiva.
- [Obter status de exportação de ativo](https://sosoapi.ai/pt-br/docs/mcp/get-asset-export-status): MCP: Obter status de exportação de ativo. Consulte o status de uma exportação de ativo: exported, verification_required, verifying, verified ou failed.
- [Solicitar exclusão definitiva de ativos](https://sosoapi.ai/pt-br/docs/mcp/request-asset-purge): MCP: Solicitar exclusão definitiva de ativos. Solicite a exclusão permanente dos bytes armazenados de ativos abrangidos por uma exportação verificada (export_id, asset_ids; confirm_history_loss pode ser obrigatório). Somente o proprietário do Workspace; irreversível após a exclusão.
- [Tentar novamente a exclusão definitiva de ativos](https://sosoapi.ai/pt-br/docs/mcp/retry-asset-purge): MCP: Tentar novamente a exclusão definitiva de ativos. Tente novamente uma solicitação de exclusão definitiva interrompida (purge_request_id). Somente o proprietário do Workspace.
- [Listar projetos](https://sosoapi.ai/pt-br/docs/mcp/list-projects): MCP: Listar projetos. Liste os projetos de um Workspace (uma camada opcional para proveniência e contas padrão) e qual está ativo.
- [Obter projeto](https://sosoapi.ai/pt-br/docs/mcp/get-project): MCP: Obter projeto. Consulte um projeto por id: nome, estado de ciclo de vida e versões de ciclo de vida e de padrões necessárias para gravações futuras.
- [Criar projeto](https://sosoapi.ai/pt-br/docs/mcp/create-project): MCP: Criar projeto. Crie um projeto em um Workspace. Somente o proprietário do Workspace; idempotency_key opcional.
- [Atualizar projeto](https://sosoapi.ai/pt-br/docs/mcp/update-project): MCP: Atualizar projeto. Renomeie um projeto (o nome é o único campo editável). Somente o proprietário do Workspace.
- [Definir projeto ativo](https://sosoapi.ai/pt-br/docs/mcp/set-active-project): MCP: Definir projeto ativo. Defina o projeto ativo do usuário (um padrão no servidor).
- [Obter contas padrão do projeto](https://sosoapi.ai/pt-br/docs/mcp/get-project-account-defaults): MCP: Obter contas padrão do projeto. Consulte as contas sociais padrão de um projeto e as substituições por conta, com defaults_version necessário para a próxima substituição.
- [Substituir contas padrão do projeto](https://sosoapi.ai/pt-br/docs/mcp/replace-project-account-defaults): MCP: Substituir contas padrão do projeto. Substitua as contas padrão e substituições de um projeto em uma etapa. Exige expected_defaults_version da consulta mais recente e idempotency_key (função editor).
- [Arquivar projeto](https://sosoapi.ai/pt-br/docs/mcp/archive-project): MCP: Arquivar projeto. Arquive um projeto sem alterar seus Scheduled Posts. Para interromper um post, cancele esse Scheduled Post separadamente. Somente o proprietário do Workspace; informe expected_lifecycle_version e idempotency_key.
- [Desarquivar projeto](https://sosoapi.ai/pt-br/docs/mcp/unarchive-project): MCP: Desarquivar projeto. Reative um projeto arquivado. Isso não retoma nem reagenda posts; gerencie-os por Scheduled Posts. Somente o proprietário do Workspace; informe expected_lifecycle_version e idempotency_key.
- [Obter histórico de ciclo de vida do projeto](https://sosoapi.ai/pt-br/docs/mcp/get-project-lifecycle-history): MCP: Obter histórico de ciclo de vida do projeto. Consulte os eventos de ciclo de vida de um projeto (como arquivamento e desarquivamento), até 200.
- [Obter perfil do projeto](https://sosoapi.ai/pt-br/docs/mcp/get-project-profile): MCP: Obter perfil do projeto. Consulte o perfil de marca de um projeto (slogan, voz, público-alvo, objetivos, paleta e mais); profile é null quando não existe.
- [Atualizar perfil do projeto](https://sosoapi.ai/pt-br/docs/mcp/update-project-profile): MCP: Atualizar perfil do projeto. Atualize parcialmente os campos de perfil de marca de um projeto. Campos omitidos permanecem intactos. Exige expected_profile_version da consulta mais recente e idempotency_key (função editor).
- [Listar ativos do projeto](https://sosoapi.ai/pt-br/docs/mcp/list-project-assets): MCP: Listar ativos do projeto. Liste os ativos vinculados a um projeto com a relação de cada vínculo (identity, source ou reference), com paginação por cursor.
- [Vincular ativo ao projeto](https://sosoapi.ai/pt-br/docs/mcp/link-project-asset): MCP: Vincular ativo ao projeto. Vincule um ativo existente a um projeto como identity, source ou reference. Função editor; idempotency_key obrigatório.
- [Desvincular ativo do projeto](https://sosoapi.ai/pt-br/docs/mcp/unlink-project-asset): MCP: Desvincular ativo do projeto. Remova o vínculo de um ativo com um projeto; o ativo em si é mantido. idempotency_key obrigatório.
- [Listar contas do projeto](https://sosoapi.ai/pt-br/docs/mcp/list-project-accounts): MCP: Listar contas do projeto. Liste as contas sociais vinculadas a um projeto, com paginação por cursor.
- [Vincular conta ao projeto](https://sosoapi.ai/pt-br/docs/mcp/link-project-account): MCP: Vincular conta ao projeto Vincule uma conta social conectada a um projeto. Função editor; idempotency_key obrigatório.
- [Desvincular conta do projeto](https://sosoapi.ai/pt-br/docs/mcp/unlink-project-account): MCP: Desvincular conta do projeto. Remova o vínculo de uma conta social com um projeto; a conta continua conectada. idempotency_key obrigatório.
- [Criar exportação de projeto](https://sosoapi.ai/pt-br/docs/mcp/create-project-export): MCP: Criar exportação de projeto. Inicie uma exportação de projeto (somente o proprietário do Workspace); consulte sosoapi_get_project_export_status periodicamente para obter a URL de download. idempotency_key obrigatório.
- [Obter status de exportação de projeto](https://sosoapi.ai/pt-br/docs/mcp/get-project-export-status): MCP: Obter status de exportação de projeto. Consulte uma exportação de projeto (export_id): queued, processing, completed (com uma URL de download de curta duração) ou failed. Somente o proprietário do Workspace.
- [Listar publicações que exigem atenção](https://sosoapi.ai/pt-br/docs/mcp/list-publication-attentions): MCP: Listar publicações que exigem atenção. Liste as publicações de um Workspace que exigem atenção, filtradas por status (open ou resolved) ou scheduled_post_id, com paginação por offset.
- [Obter créditos de publicação no X](https://sosoapi.ai/pt-br/docs/mcp/get-x-usage): MCP: Obter créditos de publicação no X Consulte os créditos de publicação no X da Organization compartilhados por este Workspace. Exige workspace_id. Free recebe 10 uma vez; Pro recebe 100 por período de cobrança. Texto custa 1, texto com URL custa 10. text opcional informa seu custo. Isso consulta a cota armazenada e não chama a API do X.
- [Listar posts agendados](https://sosoapi.ai/pt-br/docs/mcp/list-scheduled-posts): MCP: Listar posts agendados. Liste os posts agendados de um Workspace, com filtros por projeto, status (scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) e intervalo de tempo, com paginação por cursor.
- [Obter post agendado](https://sosoapi.ai/pt-br/docs/mcp/get-scheduled-post): MCP: Obter post agendado Consulte um post agendado por id: conteúdo, status, estado de entrega e resultados. Sua version é o valor necessário como expected_version para atualizar, publicar, repetir e cancelar.
- [Obter elegibilidade de post agendado](https://sosoapi.ai/pt-br/docs/mcp/get-scheduled-post-eligibility): MCP: Obter elegibilidade de post agendado. Verificação prévia somente de leitura por destino. Inclua draft (caption, hashtags, scheduled_at, display_timezone, horário local/DST opcional) para verificar conteúdo/horário; include_quota=true adiciona um retrato consultivo do período. Envie/importe mídia e aguarde a prontidão primeiro. Sem draft, apenas conta/mídia são verificadas. Não reserva nada; create/dispatch verificam novamente limites e autoridade.
- [Criar post agendado](https://sosoapi.ai/pt-br/docs/mcp/create-scheduled-post): MCP: Criar post agendado. Agende uma conta em scheduled_at com provider_payload. A mídia exige asset_id pronto e URL canônica; para uma imagem de origem, use sosoapi_post_image_url. Informe local_scheduled_at com schedule_dst_disambiguation ou omita ambos. Exige publish, função editor e idempotency_key. Agendado não significa publicado: consulte o resultado.
- [Criar posts agendados em lote](https://sosoapi.ai/pt-br/docs/mcp/bulk-create-scheduled-posts): MCP: Criar posts agendados em lote. Agende posts para várias contas em uma chamada (targets). A mídia exige asset_ids enviados/importados e prontos, com suas URLs canônicas. Cada destino tem sucesso ou falha de forma independente, informado em successes ou failures. Exige a capacidade de publicação.
- [Atualizar post agendado](https://sosoapi.ai/pt-br/docs/mcp/update-scheduled-post): MCP: Atualizar post agendado. Edite um post agendado que ainda não foi despachado (caption, hashtags, media, link, time). Exige expected_version da consulta mais recente; uma versão desatualizada é rejeitada.
- [Publicar post agendado agora](https://sosoapi.ai/pt-br/docs/mcp/publish-scheduled-post-now): MCP: Publicar post agendado agora. Publique imediatamente um post agendado em vez de em scheduled_at. Público e irreversível; exige expected_version. Na fila não significa publicado: consulte o resultado.
- [Tentar novamente o post agendado](https://sosoapi.ai/pt-br/docs/mcp/retry-scheduled-post): MCP: Tentar novamente o post agendado. Tente novamente um post agendado que falhou, opcionalmente com novo scheduled_at. Exige expected_version.
- [Excluir post agendado](https://sosoapi.ai/pt-br/docs/mcp/delete-scheduled-post): MCP: Excluir post agendado. Exclua um post agendado que não esteja publicado (scheduled, needs_reschedule, failed ou cancelled). Agentes não podem excluir conteúdo do provedor após a publicação. Exige expected_version.
- [Cancelar post agendado](https://sosoapi.ai/pt-br/docs/mcp/cancel-scheduled-post): MCP: Cancelar post agendado. Cancele um post agendado ainda não publicado para que ele nunca seja enviado. Um post publicado é recusado, e um agente também não pode excluir conteúdo publicado: o usuário faz isso no app web. Exige expected_version.
- [Retirar solicitação de exclusão](https://sosoapi.ai/pt-br/docs/mcp/withdraw-scheduled-post-delete): MCP: Retirar solicitação de exclusão. Retire uma solicitação interrompida de exclusão do Instagram Login e mantenha o post publicado. Exige expected_version.
- [Obter contagens do painel](https://sosoapi.ai/pt-br/docs/mcp/get-dashboard-counts): MCP: Obter contagens do painel Consulte as contagens operacionais de um Workspace: posts agendados, jobs recentes e contas conectadas.
- [Listar posts monitorados](https://sosoapi.ai/pt-br/docs/mcp/list-monitored-posts): MCP: Listar posts monitorados. Liste os posts sociais que o SosoAPI descobriu para um Workspace (id, platform, permalink, horário de publicação), com filtros por conta, plataforma e horário e paginação por cursor. Somente metadados, sem legendas.
- [Listar comentários de posts](https://sosoapi.ai/pt-br/docs/mcp/list-post-comments): MCP: Listar comentários de posts. Liste os comentários observados nos posts do Workspace, com a observação mais recente primeiro, autor e texto; filtre por post, conta, plataforma ou horário, com paginação por cursor. O texto é escrito por terceiros e identificado como não confiável.
- [Solicitar insights do provedor](https://sosoapi.ai/pt-br/docs/mcp/request-provider-insights): MCP: Solicitar insights do provedor. Solicite ao provedor insights de uma conta ou post em um intervalo de datas opcional (até 366 dias). Retorna request_id e, quando em cache, o resultado; caso contrário, consulte sosoapi_get_provider_insight_status periodicamente.
- [Obter status de insights do provedor](https://sosoapi.ai/pt-br/docs/mcp/get-provider-insight-status): MCP: Obter status de insights do provedor. Consulte uma solicitação de insights (request_id): queued, processing, completed (com o resultado do provedor e a disponibilidade por métrica) ou failed.
- [Iniciar OAuth do Instagram](https://sosoapi.ai/pt-br/docs/mcp/start-instagram-oauth): MCP: Iniciar OAuth do Instagram. Obtenha a authorize_url do provedor que uma pessoa deve abrir para conectar uma conta do Instagram. Informe workspace_id. Nada é conectado até a aprovação e confirmação no navegador.
- [Renovar OAuth do Instagram](https://sosoapi.ai/pt-br/docs/mcp/refresh-instagram-oauth): MCP: Renovar OAuth do Instagram. Renove o token de acesso de uma conexão do Instagram (opcionalmente um social_account_id); informa se houve renovação e a nova validade.
- [Iniciar OAuth do Threads](https://sosoapi.ai/pt-br/docs/mcp/start-threads-oauth): MCP: Iniciar OAuth do Threads. Obtenha a authorize_url do provedor que uma pessoa deve abrir para conectar uma conta do Threads. Informe workspace_id. Nada é conectado até a aprovação e confirmação no navegador.
- [Renovar OAuth do Threads](https://sosoapi.ai/pt-br/docs/mcp/refresh-threads-oauth): MCP: Renovar OAuth do Threads. Renove o token de acesso de uma conexão do Threads (opcionalmente um social_account_id); informa se houve renovação e a nova validade.
- [Verificar OAuth do Threads](https://sosoapi.ai/pt-br/docs/mcp/check-threads-oauth): MCP: Verificar OAuth do Threads. Consulte a integridade da conexão do Threads: conexão, validade, escopo e possibilidade de renovação. Informe workspace_id.
- [Iniciar OAuth da Meta](https://sosoapi.ai/pt-br/docs/mcp/start-meta-oauth): MCP: Iniciar OAuth da Meta. Obtenha a authorize_url do provedor que uma pessoa deve abrir para conectar uma Página do Facebook ou o Instagram pelo Facebook (connection_intent). Informe workspace_id. Nada é conectado até a aprovação e confirmação no navegador.
- [Renovar OAuth da Meta](https://sosoapi.ai/pt-br/docs/mcp/refresh-meta-oauth): MCP: Renovar OAuth da Meta. Verifique novamente uma conexão Facebook/Meta (social_account_id) e informe capability_verified.
- [Iniciar OAuth do YouTube](https://sosoapi.ai/pt-br/docs/mcp/start-youtube-oauth): MCP: Iniciar OAuth do YouTube. Obtenha a authorize_url do provedor que uma pessoa deve abrir para conectar um canal do YouTube. Informe workspace_id. Nada é conectado até a aprovação e confirmação no navegador.
- [Renovar OAuth do YouTube](https://sosoapi.ai/pt-br/docs/mcp/refresh-youtube-oauth): MCP: Renovar OAuth do YouTube. Renove o token de uma conexão do YouTube (social_account_id); retorna a nova validade e capability_verified.
- [Listar jobs](https://sosoapi.ai/pt-br/docs/mcp/list-jobs): MCP: Listar jobs. Liste os jobs recentes em segundo plano do usuário conectado, com status e progresso.
- [Obter status de job](https://sosoapi.ai/pt-br/docs/mcp/job-status): MCP: Obter status de job. Consulte um job em segundo plano por job_id: status, tipo e mensagem de erro se tiver falhado.
- [Obter resultado de entrega de comentário](https://sosoapi.ai/pt-br/docs/mcp/get-comment-outcome): MCP: Obter resultado de entrega de comentário. Consulte a entrega confirmada, a linhagem de recuperação, a verificação pendente e o acompanhamento não resolvido.
- [Reconciliar resultado de entrega de comentário](https://sosoapi.ai/pt-br/docs/mcp/reconcile-comment-outcome): MCP: Reconciliar resultado de entrega de comentário. Verifique uma entrega ambígua do Facebook sem reenviar ou vincule uma substituição exata confirmada. Consulte o resultado para obter prova terminal.
- [Obter capacidades da comunidade](https://sosoapi.ai/pt-br/docs/mcp/get-community-engagement-capabilities): MCP: Obter capacidades da comunidade. Consulte, por conta conectada, quais ações da comunidade (reply, hide, unhide, create_comment) são compatíveis e se a conta está elegível neste momento.
- [Consultar fila de revisão da comunidade](https://sosoapi.ai/pt-br/docs/mcp/query-community-review-queue): MCP: Consultar fila de revisão da comunidade. Consulte comentários aguardando revisão com o contexto da conversa, filtrados por prioridade, idioma, conta ou idade; uma página vazia não é sucesso. Os corpos dos comentários são escritos por terceiros e identificados como não confiáveis.
- [Enviar revisão da comunidade](https://sosoapi.ai/pt-br/docs/mcp/submit-community-review): MCP: Enviar revisão da comunidade. Registre uma nova versão de revisão imutável para um comentário: ação recomendada, reply_draft opcional, prioridade e confiança (pelo menos 0.9). Não envia nem prepara nada.
- [Preparar ação da comunidade](https://sosoapi.ai/pt-br/docs/mcp/prepare-community-action): MCP: Preparar ação da comunidade. Vincule uma versão de revisão a uma ação (reply, hide ou unhide) e obtenha um prepare_token de curta duração para sosoapi_apply_community_action. Não envia nada ainda.
- [Aplicar ação da comunidade](https://sosoapi.ai/pt-br/docs/mcp/apply-community-action): MCP: Aplicar ação da comunidade. Envie ao provedor a ação vinculada a um prepare_token; uma resposta é pública. Na fila não é sucesso: consulte sosoapi_get_community_action_status periodicamente.
- [Obter status de ação da comunidade](https://sosoapi.ai/pt-br/docs/mcp/get-community-action-status): MCP: Obter status de ação da comunidade. Consulte o comprovante terminal de uma ação da comunidade aplicada (action_id); entrar na fila não é sucesso.
- [Criar comentário da comunidade](https://sosoapi.ai/pt-br/docs/mcp/create-comment): MCP: Criar comentário da comunidade. Coloque na fila um comentário exato para um destino canônico de post ou comentário; o status não representa sucesso do provedor.
- [Obter status de comentário da comunidade](https://sosoapi.ai/pt-br/docs/mcp/get-comment-action-status): MCP: Obter status de comentário da comunidade. Consulte o comprovante terminal sanitizado de uma ação direta em comentário.
- [Obter resumo da comunidade](https://sosoapi.ai/pt-br/docs/mcp/get-community-engagement-summary): MCP: Obter resumo da comunidade. Consulte o resumo de operações da comunidade de um Workspace: modo da lane, backlog, tempos de resposta, status das ações e taxas do provedor.
- [Publicar uma imagem de uma URL](https://sosoapi.ai/pt-br/docs/mcp/post-image-url): MCP: Publicar uma imagem de uma URL Envie o post completo de imagem por URL uma vez, com media vazio. O backend o prepara e publica mesmo após desconexão. Retorna a publicação terminal se disponível em 35 segundos; caso contrário, um ID durável de post; nunca reenvie com nova chave. Exige as permissões operate e publish. Campos de horário local/DST devem ser informados juntos. import_id serve apenas para retomar clientes antigos.
- [Enviar uma imagem ou um vídeo local](https://sosoapi.ai/pt-br/docs/mcp/upload-asset): MCP: Enviar uma imagem ou um vídeo local. Envie um arquivo local de imagem ou vídeo para a biblioteca de ativos de um Workspace e registre-o como ativo. São aceitos apenas arquivos PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG reais de até 500 MiB do diretório de trabalho, pasta temporária, Pictures/Movies/Videos ou SOSOAPI_UPLOAD_ROOTS; arquivos e pastas iniciados por ponto são recusados. Retorna id e URL do ativo para mídia de Scheduled Post.