Referência de ferramentas

Esta página lista as ferramentas que o servidor MCP oferece para sellers, agrupadas por toolset. Para cada uma, você encontra:

Tipo: se a ferramenta só consulta dados (Leitura) ou se altera dados na loja (Escrita);
API: a operação da API que a ferramenta chama, com link para a referência completa (parâmetros, respostas e erros);
Escopo: a permissão do ID Magalu que a ferramenta exige. Se o token não tiver esse escopo, a ferramenta não aparece para o assistente.

O nome de cada toolset indica a visão e o assunto: seller:orders reúne as ferramentas de pedidos para quem vende.

Ferramentas para sellers

`seller:categories`

Categorias, atributos e ficha técnica do catálogo.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_categories_search`	Busca categorias do catálogo pelo nome ou ID	Leitura	Consultar categoria	`open:portfolio-categories-seller:read`
`seller_categories_get_hierarchy`	Navega a árvore de categorias: raízes, filhas de uma categoria ou o caminho até ela	Leitura	Consultar hierarquia de categoria	`open:portfolio-categories-seller:read`
`seller_categories_list_attributes`	Lista os atributos (ex.: cor, voltagem) que um SKU da categoria pode ou deve ter	Leitura	Consultar atributos de uma categoria	`open:portfolio-categories-seller:read`
`seller_categories_list_datasheet`	Lista os campos da ficha técnica de uma categoria	Leitura	Consultar atributos de ficha técnica de uma categoria	`open:portfolio-categories-seller:read`
`seller_categories_get_sku_template`	Monta o template de cadastro de SKU de uma categoria: atributos e ficha técnica	Leitura	Consultar atributos de uma categoria	`open:portfolio-categories-seller:read`

`seller:financial`

Análise financeira dos pedidos do seller.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_financial_list_orders`	Lista a análise financeira dos pedidos: valor vendido, comissão, frete e repasse	Leitura	Consultar	`open:order-financial-report-seller:read`
`seller_financial_get_order`	Consulta o demonstrativo financeiro de um pedido	Leitura	Consultar por Pedido	`open:order-financial-report-seller:read`

`seller:orders`

Pedidos do seller no Marketplace Magalu.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_orders_search`	Busca pedidos do seller aplicando filtros avançados	Leitura	Consultar	`open:order-order-seller:read`
`seller_orders_get`	Consulta os detalhes de um pedido específico	Leitura	Consultar por código	`open:order-order-seller:read`
`seller_orders_list_deliveries`	Lista as entregas do seller. Cada pedido pode ter uma ou mais entregas	Leitura	Consultar	`open:order-order-seller:read`
`seller_orders_get_delivery`	Consulta os detalhes de uma entrega	Leitura	Consultar por ID	`open:order-order-seller:read`
`seller_orders_list_delivery_history`	Lista o histórico de mudanças de status de uma entrega	Leitura	Consultar histórico	`open:order-order-seller:read`
`seller_orders_finish_delivery`	Marca uma entrega como entregue ao cliente (status delivered). A ação não pode ser desfeita	Escrita	Marcar entrega finalizada	`open:order-delivery-seller:write`
`seller_orders_ship_delivery`	Marca uma entrega como despachada (status shipped), com rastreio e previsão de entrega	Escrita	Marcar entrega enviada	`open:order-delivery-seller:write`
`seller_orders_list_delivery_invoices`	Lista as notas fiscais (NF-e) enviadas para uma entrega	Leitura	Buscar NF-es	`open:order-delivery-seller:read`
`seller_orders_create_delivery_invoice`	Envia a nota fiscal (NF-e) de uma entrega aprovada; a entrega passa a invoiced	Escrita	Enviar NF-e de entrega	`open:order-delivery-seller:write`
`seller_orders_update_delivery_invoice`	Substitui os dados de uma NF-e já enviada para a entrega	Escrita	Atualizar NF-e de entrega	`open:order-delivery-seller:write`
`seller_orders_list_fulfillment_invoices`	Lista as notas fiscais emitidas pela Magalu nas vendas com fulfillment	Leitura	Buscar NF-e de fulfillment	`open:order-invoice-seller:read`
`seller_orders_create_shipping_labels`	Gera as etiquetas de envio de uma ou mais entregas	Escrita	Gerar etiquetas	`open:order-logistics-seller:write`

`seller:products`

SKUs, preços, estoques e vídeos do seller.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_products_get_seller_info`	Retorna as informações do seller (lojista) autenticado	Leitura	Consultar informações do seller	`open:portfolio-skus-seller:read`
`seller_products_list_skus`	Lista os SKUs (produtos) do catálogo do seller com paginação	Leitura	Consultar	`open:portfolio-skus-seller:read`
`seller_products_create_sku`	Cria um novo SKU no catálogo do seller	Escrita	Criar	`open:portfolio-skus-seller:write`
`seller_products_update_sku`	Atualiza completamente um SKU existente (PUT — substitui todos os campos)	Escrita	Atualizar	`open:portfolio-skus-seller:write`
`seller_products_get_sku_validation_info`	Consulta o último evento de política de publicação de um SKU	Leitura	Consultar eventos de políticas de SKU	`open:portfolio-skus-seller:read`
`seller_products_get_price`	Consulta o preço atual de um SKU	Leitura	Consultar	`open:portfolio-prices-seller:read`
`seller_products_update_price`	Atualiza o preço de um SKU que já tem preço cadastrado. Para o primeiro preço, use seller_products_create_price	Escrita	Atualizar	`open:portfolio-prices-seller:write`
`seller_products_get_stock`	Consulta o estoque atual de um SKU	Leitura	Consultar	`open:portfolio-stocks-seller:read`
`seller_products_create_stock`	Cria o registro de estoque inicial de um SKU em um canal	Escrita	Criar	`open:portfolio-stocks-seller:write`
`seller_products_update_stock`	Altera a quantidade à venda de um SKU no marketplace; com 0, o SKU deixa de ser vendido no canal	Escrita	Atualizar	`open:portfolio-stocks-seller:write`
`seller_products_list_videos`	Lista os vídeos associados a um SKU	Leitura	Consultar vídeos de um produto específico	`open:portfolio-skus-seller:read`
`seller_products_request_video_upload`	Inicia o processo de upload de vídeo para um SKU	Escrita	Iniciar processo de upload de vídeo	`open:portfolio-skus-seller:write`
`seller_products_confirm_video_upload`	Confirma que o upload do vídeo foi concluído e inicia a validação	Escrita	Confirmar o upload de um vídeo	`open:portfolio-skus-seller:write`
`seller_products_get_video`	Consulta os detalhes e status de um vídeo específico	Leitura	Consultar detalhes de um vídeo específico	`open:portfolio-skus-seller:read`
`seller_products_get_sku`	Consulta todos os dados cadastrados de um SKU	Leitura	Consultar pelo SKU	`open:portfolio-skus-seller:read`
`seller_products_patch_sku`	Atualiza só os campos informados de um SKU, sem reenviar o cadastro inteiro	Escrita	Atualizar (parcial)	`open:portfolio-skus-seller:write`
`seller_products_create_price`	Cadastra o primeiro preço de um SKU em um canal. Para alterar depois, use seller_products_update_price	Escrita	Criar	`open:portfolio-prices-seller:write`
`seller_products_list_all_videos`	Lista os vídeos de todo o portfólio do seller, com filtros	Leitura	Consultar todos os vídeos do portfólio	`open:portfolio-skus-seller:read`
`seller_products_request_bulk_video_upload`	Inicia o upload de um vídeo associado a vários SKUs de uma vez	Escrita	Iniciar processo de múltiplos uploads de vídeos	`open:portfolio-skus-seller:write`
`seller_products_list_scores`	Lista a nota de qualidade do cadastro dos produtos em um canal	Leitura	Consultar	`open:portfolio-scores-seller:read`

`seller:promotions`

Promoções do seller no Marketplace Magalu.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_promotions_list`	Lista as promoções em que o seller pode participar ou já participa	Leitura	Consultar promoções elegíveis	`open:promotion-promotions-seller:read`
`seller_promotions_create`	Cria uma promoção do próprio seller (self service)	Escrita	Criar promoção	`open:promotion-promotions-seller:write`
`seller_promotions_get`	Consulta os detalhes de uma promoção	Leitura	Consultar detalhes de uma promoção	`open:promotion-promotions-seller:read`
`seller_promotions_apply`	Efetiva as alterações pendentes de SKUs (inclusões, preços e remoções) de uma promoção, com efeito imediato	Escrita	Aplicar alterações pendentes de uma promoção	`open:promotion-skus-seller:write`
`seller_promotions_get_performance`	Consulta vendas, investimento e uso de uma promoção	Leitura	Consultar performance de uma promoção	`open:promotion-promotions-seller:read`
`seller_promotions_list_skus`	Lista os SKUs do seller que participam de uma promoção	Leitura	Consultar SKUs de uma promoção	`open:promotion-skus-seller:read`
`seller_promotions_get_sku`	Consulta um SKU dentro de uma promoção	Leitura	Consultar SKU de uma promoção por ID	`open:promotion-skus-seller:read`
`seller_promotions_update_sku`	Inclui um SKU na promoção ou altera o preço promocional ou o limite de unidades dele	Escrita	Atualizar dados de um SKU de uma promoção	`open:promotion-skus-seller:write`
`seller_promotions_remove_sku`	Remove um SKU de uma promoção	Escrita	Remover SKU de uma promoção	`open:promotion-skus-seller:write`
`seller_promotions_subscribe`	Inscreve o seller em uma promoção do canal	Escrita	Inscrever-se em uma promoção	`open:promotion-subscriptions-seller:write`
`seller_promotions_unsubscribe`	Cancela a inscrição do seller em uma promoção	Escrita	Cancelar inscrição em uma promoção	`open:promotion-subscriptions-seller:write`

`seller:vehicles`

Compatibilidade de autopeças com veículos.

Ferramenta	O que faz	Tipo	API	Escopo
`seller_vehicles_list_manufacturers`	Lista os fabricantes de veículos. Primeiro passo para chegar à versão do veículo	Leitura	Consultar fabricantes	`open:portfolio-vehicles-seller:read`
`seller_vehicles_list_models`	Lista os modelos de um fabricante	Leitura	Consultar modelos	`open:portfolio-vehicles-seller:read`
`seller_vehicles_list_years`	Lista os anos disponíveis de um modelo	Leitura	Consultar anos do modelo	`open:portfolio-vehicles-seller:read`
`seller_vehicles_list_versions`	Lista as versões de um modelo em um ano. O ID da versão é o que entra na compatibilidade	Leitura	Consultar versões	`open:portfolio-vehicles-seller:read`
`seller_vehicles_add_compatibilities`	Adiciona versões de veículos compatíveis com uma autopeça (SKU)	Escrita	Criar compatibilidades	`open:portfolio-vehicles-compatibility-seller:write`
`seller_vehicles_replace_compatibilities`	Substitui toda a lista de veículos compatíveis de uma autopeça (SKU)	Escrita	Atualizar compatibilidades	`open:portfolio-vehicles-compatibility-seller:write`
`seller_vehicles_remove_compatibilities`	Remove todas as compatibilidades de veículos de uma autopeça (SKU)	Escrita	Remover compatibilidades	`open:portfolio-vehicles-compatibility-seller:write`

Ferramentas do servidor

Estas aparecem para qualquer conta e não chamam APIs da loja.

Ferramenta	O que faz
`magalu_list_modules`	Lista os toolsets que o token permite usar
`magalu_list_channels`	Lista os canais de venda da loja, com o ID que o assistente usa em preço, estoque, cadastro e promoções. Só no servidor de sellers
`list_toolsets`, `get_toolset_tools`, `enable_toolset`	Descoberta de toolsets no modo dinâmico. Veja Para desenvolvedores

Ferramentas para sellers​

seller:categories​

seller:financial​

seller:orders​

seller:products​

seller:promotions​

seller:vehicles​

Ferramentas do servidor​