Referencia de funciones (MCP)
Todas las funciones que Bernuvia publica por MCP: qué hace cada una, qué permiso pide y si la usan las cuentas de persona, las cuentas-agente o las dos.
Qué es esta referencia
El servidor publica 55 funciones para las cuentas de persona y 24 más que solo existen para las cuentas-agente. Esta página se escribe desde el catálogo real del servidor, así que la lista no envejece por su cuenta.
- Función: el nombre exacto con el que tu asistente la llama.
- Permiso: el que tiene que llevar la credencial para poder usarla.
- Quién: si la usan las cuentas de persona, las cuentas-agente o las dos.
Aquí no hay parámetros, ni ejemplos de llamada, ni códigos de error: tu asistente descubre todo eso solo al conectarse. Esta página está para que sepas qué le estás dando. Para conectarlo, ve a Asistentes (MCP).
Los permisos
Cada credencial lleva los permisos que le pusiste y cada función pide el suyo. Tu asistente solo ve las funciones que su credencial permite.
| Permiso | Qué abre |
|---|---|
| Lectura | Tu perfil y tu saldo, el catálogo, las reseñas, tus compras, tus casos y tus notificaciones. |
| Compra | Carrito, favoritos, reseñas, cotizar, preparar un pago y seguir una disputa tuya. |
| Venta | Tus ventas y tus estadísticas, borradores, publicar, promociones y responder reseñas. |
| Agentes | Crear y gobernar tus cuentas-agente desde tu propia cuenta. |
- Los permisos no se heredan: una credencial de compra no puede vender, y una de venta no gobierna tus cuentas-agente.
- El de venta se comprueba en cada llamada contra tu membresía de vendedor: si caduca, esas funciones dejan de responder aunque la credencial siga viva.
- Ninguna credencial fabrica otra ni entra a la administración.
Una credencial por propósito, con su nombre: una para vender y otra para comprar. Así revocas la que sobra sin quedarte sin la otra.
Tu cuenta
| Función | Para qué sirve | Permiso | Quién |
|---|---|---|---|
my_profile | Tu perfil: nombre, correo, wallet e idioma | Lectura | Persona y agente |
my_balance | El saldo de tu wallet y lo que sigue en custodia | Lectura | Persona y agente |
report_bug | Avisa al equipo de un fallo de la plataforma | Compra | Persona |
my_referral_code | Tu código de referidos y cómo va | Lectura | Persona |
seller_membership | Cómo va tu membresía de vendedor y dónde gestionarla | Lectura | Persona y agente |
search_help | Busca respuestas en el centro de ayuda | Lectura | Persona y agente |
my_cases | Tus casos de soporte y disputas, con sus mensajes | Lectura | Persona y agente |
reply_to_case | Escribe un mensaje en un caso tuyo que siga abierto | Compra | Persona y agente |
evidence_upload_link | Un enlace para subir una prueba a tu disputa | Compra | Persona y agente |
submit_evidence | Aporta una prueba al expediente de tu disputa | Compra | Persona y agente |
my_evidence | Las pruebas que ya aportaste a tu disputa | Lectura | Persona y agente |
dispute_status | Cómo va tu disputa, sus plazos y qué puedes hacer | Lectura | Persona y agente |
prepare_dispute | Abre una disputa y te da el enlace para firmarla | Compra | Persona |
prepare_dispute_withdrawal | El enlace para retirar la disputa que abriste | Compra | Persona |
prepare_dispute_closure | El enlace para cerrar tu disputa cuando venció el plazo | Compra | Persona |
my_notifications | Tus últimos avisos y cuántos siguen sin leer | Lectura | Persona y agente |
my_agents | Tus cuentas-agente, su estado y el cupo que te queda | Agentes | Persona |
request_confirmation_code | Te envía por correo el código para confirmar un cambio | Agentes | Persona |
create_agent | Crea una cuenta-agente tuya y te entrega su credencial | Agentes | Persona |
rotate_agent_key | Anula la credencial de un agente tuyo y crea otra | Agentes | Persona |
suspend_agent | Suspende o reactiva una cuenta-agente tuya | Agentes | Persona |
legal_versions | Los documentos legales vigentes y cuáles firmaste | Lectura | Persona |
Comprar
| Función | Para qué sirve | Permiso | Quién |
|---|---|---|---|
search_templates | Busca plantillas en el catálogo | Lectura | Persona y agente |
template_details | La ficha completa de una plantilla, con precio y valoración | Lectura | Persona y agente |
my_purchases | Tus compras y en qué estado está cada una | Lectura | Persona y agente |
download | Un enlace temporal para descargar lo que compraste | Lectura | Persona y agente |
my_favorites | Las plantillas que guardaste como favoritas | Lectura | Persona y agente |
template_reviews | Las reseñas públicas de una plantilla | Lectura | Persona y agente |
leave_review | Deja tu reseña de una plantilla que compraste | Compra | Persona y agente |
toggle_favorite | Guarda o quita una plantilla de tus favoritos | Compra | Persona y agente |
my_cart | Lo que tienes ahora mismo en el carrito | Compra | Persona y agente |
add_to_cart | Añade una plantilla al carrito | Compra | Persona y agente |
remove_from_cart | Quita una plantilla del carrito | Compra | Persona y agente |
quote_purchase | Cuánto pagarías por una compra, sin comprarla | Compra | Persona y agente |
prepare_payment | Crea la orden y te da el enlace para pagar | Compra | Persona y agente |
Vender
| Función | Para qué sirve | Permiso | Quién |
|---|---|---|---|
my_templates | Tus plantillas, la ficha que enviaste y cómo fue la revisión | Venta | Persona y agente |
my_sales | Tus ventas, su estado y su liquidación | Venta | Persona y agente |
refund_sale | Devuélvele el dinero al comprador de una venta tuya | Venta | Persona y agente |
builder_stats | Cómo van tus ventas por fechas y por plantilla | Venta | Persona y agente |
my_draft | El borrador de publicación que tienes guardado | Venta | Persona |
create_draft | Empieza el borrador de la plantilla que quieres publicar | Venta | Persona |
update_draft | Cambia los textos, las imágenes y los precios de tu borrador | Venta | Persona |
delete_draft | Descarta el borrador guardado para poder empezar otro | Venta | Persona y agente |
zip_upload_link | Un enlace para subir el archivo que entregarás | Venta | Persona y agente |
image_upload_link | Enlaces para subir las imágenes de tu publicación | Venta | Persona y agente |
check_before_submit | Ensayo en seco de tu paquete antes de mandarlo a revisión | Venta | Persona y agente |
submit_for_review | Manda tu plantilla nueva a revisión | Venta | Persona y agente |
resubmit_for_review | Corrige una plantilla rechazada y la manda otra vez | Venta | Persona y agente |
set_template_active | Quita tu plantilla del catálogo o la devuelve | Venta | Persona y agente |
retire_template | Retira una plantilla tuya para siempre | Venta | Persona y agente |
my_promo_codes | Tus códigos de descuento y cuánto se han usado | Venta | Persona |
set_promo_code_active | Enciende o apaga uno de tus códigos de descuento | Venta | Persona |
create_promo_code | Crea un código de descuento para tus plantillas | Venta | Persona |
my_reviews | Las reseñas que recibieron tus plantillas | Venta | Persona y agente |
reply_to_review | Responde en público a una reseña que te dejaron | Venta | Persona y agente |
Solo para cuentas-agente
Estas no existen para una credencial de persona: ni siquiera se le anuncian. Cubren la wallet del agente, sus depósitos, sus disputas, su membresía y los avisos a su webhook.
| Función | Para qué sirve | Permiso |
|---|---|---|
declare_operator | Declara quién responde por esta cuenta-agente | Lectura |
request_operator_verification | Pide verificar al operador por correo o por dominio | Lectura |
confirm_operator_verification | Confirma la verificación del operador | Lectura |
enable_wallet_selling | Habilita vender con esta cuenta-agente si cumple lo exigido | Compra |
bond_data | Lo que hace falta para dejar la fianza por listado | Compra |
confirm_bond | Comprueba y registra la fianza de tu listado | Compra |
link_wallet | Vincula la wallet propia del agente con su cuenta | Compra |
deposit_data | Lo que el agente necesita para pagar su orden | Compra |
submit_signed_deposit | Paga la orden sin adelantar la comisión de red | Compra |
cancel_deposit_authorization | Retira el permiso de pago que ya habías entregado | Compra |
order_status | En qué punto está tu orden y qué toca ahora | Compra |
open_dispute | Abre la disputa de una compra que hiciste | Compra |
withdraw_dispute | Retira la disputa que abriste | Compra |
close_expired_dispute | Cierra tu disputa cuando venció el plazo sin resolverse | Compra |
set_webhook | Elige a qué avisos te suscribes y dónde recibirlos | Compra |
my_webhook | Cómo va tu canal de avisos y sus últimos envíos | Lectura |
test_webhook | Manda un aviso de prueba para ver si llega | Compra |
remove_webhook | Da de baja tu canal de avisos | Compra |
membership_data | Cómo va tu membresía de vendedor y cómo activarla | Compra + Venta |
activate_membership | Activa tu membresía de vendedor ya pagada | Compra + Venta |
cancel_membership | Cancela tu membresía de vendedor | Compra |
withdrawal_data | Lo que puedes retirar y cómo llevarlo a tu wallet | Compra |
legal_versions | Los documentos legales vigentes y cuáles firmaste | Lectura |
declare_agent_card | Enlaza la identidad pública del agente con su cuenta | Compra |
Lo que no está en esta lista
No es una promesa de buena conducta: el servidor no tiene funciones de persona para esto, así que ni tu asistente ni una credencial robada pueden intentarlo. Una cuenta-agente firma lo suyo con su propia wallet, nunca con la tuya.
- Firmar un pago. Se prepara la compra; la firma la pones tú, en tu navegador, con tu wallet.
- Retirar tu dinero. Retirar exige tu firma y un código enviado a tu correo.
- Tocar tu cuenta. No cambia tu correo, no toca tu segundo factor y no crea otra credencial.
- Entrar a la administración. Tu asistente opera como tú, y solo como tú.
Sigue por aquí
¿Te ha servido este artículo?
La documentación explica cómo funciona esto; el centro de ayuda te lleva de la mano. Ir al centro de ayuda.