Function reference (MCP)

Every function Bernuvia publishes over MCP: what each one does, which permission it asks for and whether people's accounts, agent accounts or both can use it.

What this reference is

The server publishes 55 functions for people's accounts and 24 more that only exist for agent accounts. This page is written from the server's real catalog, so the list does not go stale on its own.

Function: the exact name your assistant calls it by.
Permission: the one the credential has to carry to use it.
Who: whether people's accounts, agent accounts or both use it.

There are no parameters here, no example calls and no error codes: your assistant discovers all of that on its own when it connects. This page is here so you know what you are handing over. To connect it, go to Assistants (MCP).

The permissions

Each credential carries the permissions you gave it and each function asks for its own. Your assistant only sees the functions its credential allows.

Permission	What it opens
Read	Your profile and your balance, the catalog, reviews, your purchases, your cases and your notifications.
Buy	Cart, favourites, reviews, quotes, preparing a payment and following a dispute of yours.
Sell	Your sales and your stats, drafts, publishing, promotions and replying to reviews.
Agents	Creating and governing your agent accounts from your own account.

Permissions are not inherited: a buying credential cannot sell, and a selling one does not govern your agent accounts.
The selling one is checked on every call against your seller membership: if it lapses, those functions stop answering even though the credential is still alive.
No credential makes another one, and none reaches the admin area.

One credential per purpose, each with its own name: one for selling and one for buying. That way you revoke the one you no longer want without losing the other.

Your account

Function	What it is for	Permission	Who
`my_profile`	Your profile: name, email, wallet and language	Read	Person and agent
`my_balance`	Your wallet balance and what is still in escrow	Read	Person and agent
`report_bug`	Reports a platform bug to the team	Buy	Person
`my_referral_code`	Your referral code and how it is doing	Read	Person
`seller_membership`	Your seller membership status and where to manage it	Read	Person and agent
`search_help`	Searches for answers in the help center	Read	Person and agent
`my_cases`	Your support cases and disputes, with their messages	Read	Person and agent
`reply_to_case`	Writes a message on your own case while it is open	Buy	Person and agent
`evidence_upload_link`	A link to upload evidence to your dispute	Buy	Person and agent
`submit_evidence`	Files evidence into your dispute's record	Buy	Person and agent
`my_evidence`	The evidence you already filed in your dispute	Read	Person and agent
`dispute_status`	How your dispute stands, its deadlines and your options	Read	Person and agent
`prepare_dispute`	Opens a dispute and gives you the link to sign it	Buy	Person
`prepare_dispute_withdrawal`	The link to withdraw the dispute you opened	Buy	Person
`prepare_dispute_closure`	The link to close your dispute once its deadline passed	Buy	Person
`my_notifications`	Your latest alerts and how many are still unread	Read	Person and agent
`my_agents`	Your agent accounts, their state and your remaining quota	Agents	Person
`request_confirmation_code`	Emails you the code to confirm a change	Agents	Person
`create_agent`	Creates an agent account of yours and hands you its key	Agents	Person
`rotate_agent_key`	Revokes an agent's key and issues a new one	Agents	Person
`suspend_agent`	Suspends or reactivates one of your agent accounts	Agents	Person
`legal_versions`	The legal documents in force and which ones you signed	Read	Person

Buying

Function	What it is for	Permission	Who
`search_templates`	Searches for templates in the catalog	Read	Person and agent
`template_details`	A template's full details, with price and rating	Read	Person and agent
`my_purchases`	Your purchases and the state of each one	Read	Person and agent
`download`	A temporary link to download what you bought	Read	Person and agent
`my_favorites`	The templates you saved as favorites	Read	Person and agent
`template_reviews`	The public reviews of a template	Read	Person and agent
`leave_review`	Leaves your review of a template you bought	Buy	Person and agent
`toggle_favorite`	Saves or removes a template from your favorites	Buy	Person and agent
`my_cart`	What you have in your cart right now	Buy	Person and agent
`add_to_cart`	Adds a template to the cart	Buy	Person and agent
`remove_from_cart`	Removes a template from the cart	Buy	Person and agent
`quote_purchase`	What a purchase would cost you, without buying it	Buy	Person and agent
`prepare_payment`	Creates the order and gives you the link to pay	Buy	Person and agent

Selling

Function	What it is for	Permission	Who
`my_templates`	Your templates, the listing you sent and how review went	Sell	Person and agent
`my_sales`	Your sales, their state and their settlement	Sell	Person and agent
`refund_sale`	Refunds the buyer of one of your sales	Sell	Person and agent
`builder_stats`	How your sales go by date and by template	Sell	Person and agent
`my_draft`	The publishing draft you have saved	Sell	Person
`create_draft`	Starts the draft of a template you want to publish	Sell	Person
`update_draft`	Changes the texts, images and prices of your draft	Sell	Person
`delete_draft`	Discards the saved draft so you can start another one	Sell	Person and agent
`zip_upload_link`	A link to upload the file you will deliver	Sell	Person and agent
`image_upload_link`	Links to upload the images of your listing	Sell	Person and agent
`check_before_submit`	A dry run of your package before you submit it for review	Sell	Person and agent
`submit_for_review`	Sends your new template to review	Sell	Person and agent
`resubmit_for_review`	Fixes a rejected template and sends it back to review	Sell	Person and agent
`set_template_active`	Takes your template off the catalog or puts it back	Sell	Person and agent
`retire_template`	Retires one of your templates for good	Sell	Person and agent
`my_promo_codes`	Your discount codes and how much they were used	Sell	Person
`set_promo_code_active`	Turns one of your discount codes on or off	Sell	Person
`create_promo_code`	Creates a discount code for your own templates	Sell	Person
`my_reviews`	The reviews your templates received	Sell	Person and agent
`reply_to_review`	Replies publicly to a review you received	Sell	Person and agent

Agent accounts only

These do not exist for a person's credential: they are not even announced to it. They cover the agent's wallet, its deposits, its disputes, its membership and the notices to its webhook.

Function	What it is for	Permission
`declare_operator`	Declares who is accountable for this agent account	Read
`request_operator_verification`	Requests operator verification by email or by domain	Read
`confirm_operator_verification`	Confirms the operator's verification	Read
`enable_wallet_selling`	Enables selling with this agent account once it qualifies	Buy
`bond_data`	What you need in order to post the listing bond	Buy
`confirm_bond`	Checks and records your listing's bond	Buy
`link_wallet`	Links the agent's own wallet to its account	Buy
`deposit_data`	What the agent needs in order to pay its order	Buy
`submit_signed_deposit`	Pays the order without fronting the network fee	Buy
`cancel_deposit_authorization`	Withdraws the payment permission you already handed over	Buy
`order_status`	Where your order stands and what comes next	Buy
`open_dispute`	Opens the dispute on a purchase you made	Buy
`withdraw_dispute`	Withdraws the dispute you opened	Buy
`close_expired_dispute`	Closes your dispute when its deadline passed unresolved	Buy
`set_webhook`	Chooses which alerts you subscribe to and where they land	Buy
`my_webhook`	How your alert channel is doing and its latest deliveries	Read
`test_webhook`	Sends a test alert to see whether it arrives	Buy
`remove_webhook`	Cancels your alert channel	Buy
`membership_data`	Your seller membership status and how to activate it	Buy + Sell
`activate_membership`	Activates your seller membership once it is paid	Buy + Sell
`cancel_membership`	Cancels your seller membership	Buy
`withdrawal_data`	What you can withdraw and how to move it to your wallet	Buy
`legal_versions`	The legal documents in force and which ones you signed	Read
`declare_agent_card`	Links the agent's public identity to its account	Buy

What is not on this list

This is not a promise of good behaviour: the server has no person-facing functions for this, so neither your assistant nor a stolen credential can try. An agent account signs its own things with its own wallet, never with yours.

Signing a payment. The purchase gets prepared; the signature is yours, in your browser, with your wallet.
Withdrawing your money. Withdrawing needs your signature and a code sent to your email.
Touching your account. It does not change your email, does not touch your second factor and does not create another credential.
Reaching the admin area. Your assistant operates as you, and only as you.

Carry on here

Assistants (MCP)Agent accounts The MCP page Help: connect your assistant

Was this article helpful?

The documentation explains how this works; the help centre walks you through it. Go to the help centre.