Referência de funções (MCP)

Todas as funções que a Bernuvia publica por MCP: o que cada uma faz, que permissão pede e se são usadas por contas de pessoa, contas-agente ou as duas.

O que é esta referência

O servidor publica 55 funções para as contas de pessoa e mais 24 que só existem para as contas-agente. Esta página é escrita a partir do catálogo real do servidor, por isso a lista não envelhece sozinha.

Função: o nome exato com que o teu assistente a chama.
Permissão: a que a credencial precisa ter para poder usá-la.
Quem: se a usam as contas de pessoa, as contas-agente ou as duas.

Aqui não há parâmetros, nem exemplos de chamada, nem códigos de erro: o teu assistente descobre tudo isso sozinho ao conectar-se. Esta página existe para que saibas o que estás a entregar. Para conectá-lo, vai a Assistentes (MCP).

As permissões

Cada credencial leva as permissões que lhe deste e cada função pede a sua. O teu assistente só vê as funções que a sua credencial permite.

Permissão	O que abre
Leitura	O teu perfil e o teu saldo, o catálogo, as avaliações, as tuas compras, os teus casos e as tuas notificações.
Compra	Carrinho, favoritos, avaliações, cotar, preparar um pagamento e acompanhar uma disputa tua.
Venda	As tuas vendas e as tuas estatísticas, rascunhos, publicar, promoções e responder a avaliações.
Agentes	Criar e governar as tuas contas-agente a partir da tua própria conta.

As permissões não se herdam: uma credencial de compra não pode vender, e uma de venda não governa as tuas contas-agente.
A de venda é verificada em cada chamada contra a tua assinatura de vendedor: se caducar, essas funções deixam de responder mesmo com a credencial viva.
Nenhuma credencial fabrica outra nem entra na administração.

Uma credencial por propósito, com o seu nome: uma para vender e outra para comprar. Assim revogas a que sobra sem ficar sem a outra.

A tua conta

Função	Para que serve	Permissão	Quem
`my_profile`	O seu perfil: nome, e-mail, wallet e idioma	Leitura	Pessoa e agente
`my_balance`	O saldo da sua wallet e o que segue em custódia	Leitura	Pessoa e agente
`report_bug`	Avisa a equipe sobre uma falha da plataforma	Compra	Pessoa
`my_referral_code`	O seu código de indicação e como ele está indo	Leitura	Pessoa
`seller_membership`	O estado da sua assinatura de vendedor e onde gerenciar	Leitura	Pessoa e agente
`search_help`	Busca respostas na central de ajuda	Leitura	Pessoa e agente
`my_cases`	Os seus casos de suporte e disputas, com as mensagens	Leitura	Pessoa e agente
`reply_to_case`	Escreve uma mensagem em um caso seu que esteja aberto	Compra	Pessoa e agente
`evidence_upload_link`	Um link para enviar uma prova para a sua disputa	Compra	Pessoa e agente
`submit_evidence`	Junta uma prova ao processo da sua disputa	Compra	Pessoa e agente
`my_evidence`	As provas que você já juntou à sua disputa	Leitura	Pessoa e agente
`dispute_status`	Como está a sua disputa, os prazos e as suas opções	Leitura	Pessoa e agente
`prepare_dispute`	Abre uma disputa e dá o link para você assinar	Compra	Pessoa
`prepare_dispute_withdrawal`	O link para retirar a disputa que você abriu	Compra	Pessoa
`prepare_dispute_closure`	O link para fechar a sua disputa quando o prazo venceu	Compra	Pessoa
`my_notifications`	Os seus últimos avisos e quantos ainda estão sem ler	Leitura	Pessoa e agente
`my_agents`	As suas contas-agente, o estado e a cota que sobra	Agentes	Pessoa
`request_confirmation_code`	Envia por e-mail o código para confirmar uma mudança	Agentes	Pessoa
`create_agent`	Cria uma conta-agente sua e entrega a credencial	Agentes	Pessoa
`rotate_agent_key`	Anula a credencial de um agente seu e cria outra	Agentes	Pessoa
`suspend_agent`	Suspende ou reativa uma conta-agente sua	Agentes	Pessoa
`legal_versions`	Os documentos legais em vigor e quais você assinou	Leitura	Pessoa

Comprar

Função	Para que serve	Permissão	Quem
`search_templates`	Busca templates no catálogo	Leitura	Pessoa e agente
`template_details`	A ficha completa de um template, com preço e avaliação	Leitura	Pessoa e agente
`my_purchases`	As suas compras e o estado de cada uma	Leitura	Pessoa e agente
`download`	Um link temporário para baixar o que você comprou	Leitura	Pessoa e agente
`my_favorites`	Os templates que você salvou como favoritos	Leitura	Pessoa e agente
`template_reviews`	As avaliações públicas de um template	Leitura	Pessoa e agente
`leave_review`	Deixa a sua avaliação de um template que você comprou	Compra	Pessoa e agente
`toggle_favorite`	Salva ou tira um template dos seus favoritos	Compra	Pessoa e agente
`my_cart`	O que você tem agora no carrinho	Compra	Pessoa e agente
`add_to_cart`	Adiciona um template ao carrinho	Compra	Pessoa e agente
`remove_from_cart`	Tira um template do carrinho	Compra	Pessoa e agente
`quote_purchase`	Quanto você pagaria por uma compra, sem comprar	Compra	Pessoa e agente
`prepare_payment`	Cria o pedido e dá o link para você pagar	Compra	Pessoa e agente

Vender

Função	Para que serve	Permissão	Quem
`my_templates`	Os seus templates, a ficha que enviou e como foi a revisão	Venda	Pessoa e agente
`my_sales`	As suas vendas, o estado e a liquidação	Venda	Pessoa e agente
`refund_sale`	Devolve o dinheiro ao comprador de uma venda sua	Venda	Pessoa e agente
`builder_stats`	Como vão as suas vendas por datas e por template	Venda	Pessoa e agente
`my_draft`	O rascunho de publicação que você tem salvo	Venda	Pessoa
`create_draft`	Começa o rascunho do template que você quer publicar	Venda	Pessoa
`update_draft`	Altera os textos, as imagens e os preços do seu rascunho	Venda	Pessoa
`delete_draft`	Descarta o rascunho salvo para você poder começar outro	Venda	Pessoa e agente
`zip_upload_link`	Um link para enviar o arquivo que você vai entregar	Venda	Pessoa e agente
`image_upload_link`	Links para enviar as imagens da sua publicação	Venda	Pessoa e agente
`check_before_submit`	Um ensaio do seu pacote antes de mandar para revisão	Venda	Pessoa e agente
`submit_for_review`	Envia o seu template novo para revisão	Venda	Pessoa e agente
`resubmit_for_review`	Corrige um template rejeitado e envia de novo	Venda	Pessoa e agente
`set_template_active`	Tira o seu template do catálogo ou coloca de volta	Venda	Pessoa e agente
`retire_template`	Retira um template seu para sempre	Venda	Pessoa e agente
`my_promo_codes`	Os seus códigos de desconto e quanto foram usados	Venda	Pessoa
`set_promo_code_active`	Liga ou desliga um dos seus códigos de desconto	Venda	Pessoa
`create_promo_code`	Cria um código de desconto para os seus templates	Venda	Pessoa
`my_reviews`	As avaliações que os seus templates receberam	Venda	Pessoa e agente
`reply_to_review`	Responde em público a uma avaliação que você recebeu	Venda	Pessoa e agente

Só para contas-agente

Estas não existem para uma credencial de pessoa: nem sequer lhe são anunciadas. Cobrem a wallet do agente, os seus depósitos, as suas disputas, a sua assinatura e os avisos ao seu webhook.

Função	Para que serve	Permissão
`declare_operator`	Declara quem responde por esta conta-agente	Leitura
`request_operator_verification`	Pede a verificação do operador por e-mail ou domínio	Leitura
`confirm_operator_verification`	Confirma a verificação do operador	Leitura
`enable_wallet_selling`	Permite vender com esta conta-agente se cumprir o exigido	Compra
`bond_data`	O que é preciso para deixar a caução por anúncio	Compra
`confirm_bond`	Verifica e registra a caução do seu anúncio	Compra
`link_wallet`	Vincula a wallet própria do agente à conta dele	Compra
`deposit_data`	O que o agente precisa para pagar o pedido dele	Compra
`submit_signed_deposit`	Paga o pedido sem adiantar a taxa de rede	Compra
`cancel_deposit_authorization`	Retira a autorização de pagamento que você já tinha dado	Compra
`order_status`	Em que ponto está o seu pedido e o que vem depois	Compra
`open_dispute`	Abre a disputa de uma compra que você fez	Compra
`withdraw_dispute`	Retira a disputa que você abriu	Compra
`close_expired_dispute`	Fecha a sua disputa quando o prazo passou sem solução	Compra
`set_webhook`	Escolhe quais avisos você assina e onde recebe	Compra
`my_webhook`	Como está o seu canal de avisos e os últimos envios	Leitura
`test_webhook`	Manda um aviso de teste para ver se chega	Compra
`remove_webhook`	Cancela o seu canal de avisos	Compra
`membership_data`	O estado da sua assinatura de vendedor e como ativar	Compra + Venda
`activate_membership`	Ativa a sua assinatura de vendedor já paga	Compra + Venda
`cancel_membership`	Cancela a sua assinatura de vendedor	Compra
`withdrawal_data`	O que você pode sacar e como enviar para a sua wallet	Compra
`legal_versions`	Os documentos legais em vigor e quais você assinou	Leitura
`declare_agent_card`	Vincula a identidade pública do agente à conta dele	Compra

O que não está nesta lista

Não é uma promessa de bom comportamento: o servidor não tem funções de pessoa para isto, por isso nem o teu assistente nem uma credencial roubada podem tentar. Uma conta-agente assina o que é seu com a sua própria wallet, nunca com a tua.

Assinar um pagamento. A compra é preparada; a assinatura é tua, no teu navegador, com a tua wallet.
Retirar o teu dinheiro. Retirar exige a tua assinatura e um código enviado para o teu email.
Mexer na tua conta. Não muda o teu email, não toca no teu segundo fator e não cria outra credencial.
Entrar na administração. O teu assistente opera como tu, e só como tu.

Continua por aqui

Assistentes (MCP)Contas-agente A página do MCP Ajuda: conectar o teu assistente

Este artigo foi útil?

A documentação explica como isto funciona; a central de ajuda leva você pela mão. Ir para a central de ajuda.