Tools disponibles del MCP server
Mercado Pago MCP Server ofrece la siguiente lista de tools.
| Tool | Descripción | Parámetros | Prompt sugerido |
search-documentation | Realiza búsquedas de código o texto en la documentación de Mercado Pago Developers. | -query (string, required): Término a buscar. - language (string, required, enum): Idioma en el que se realiza la búsqueda. Los valores permitidos son 'es' (español), 'en' (english), 'pt' (português). | Busca en la documentación de Mercado Pago {query} |
quality_checklist | Obtiene una lista detallada de los campos evaluados por Mercado Pago para optimizar la calidad de tu integración. Además, proporciona recomendaciones de buenas prácticas para mejorar la calidad de tu implementación durante la etapa de desarrollo, para garantizar una salida a producción adecuada a los estándares necesarios. | N/A | Bríndame la lista de campos que debe cumplir mi integracion para aprobar los estándares de calidad de Mercado Pago. Formatea la salida en dos tablas, la primera con los campos requeridos y la segunda con mejoras opcionales o buenas prácticas, si las hay. |
quality_evaluation | A partir de un identificador de pago productivo, mide la calidad de tu integración, evaluando su correcto funcionamiento y adecuación a los estándares de Mercado Pago. | -payment_id (number, required): Identificador del pago que servirá para realizar la medición de calidad. | Evalúa la calidad de mi integración usando el {payment_id}. En caso de ser necesario, propone mejoras para alcanzar el mejor puntaje posible. |
save_webhook | Configura o actualiza las configuraciones de notificaciones Webhooks para recibir alertas de Mercado Pago sobre las transacciones asociadas a una aplicación, incluyendo tópicos de notificación, URLs de producción y de prueba. | -callback (string, optional): URL de producción a la que se enviarán las notificaciones Webhooks. - callback_sandbox (string, optional): URL de prueba a la que se enviarán las notificaciones Webhooks. - topics (array, string, optional): Listado de tópicos que se desean configurar para recibir notificaciones. Si no es enviado, se considerará el tópico payment por defecto. | Configura notificaciones Webhooks de {topics} para pruebas con la URL {callback}. |
notifications_history_diagnostics | Realiza un diagnóstico y obtiene informes de los eventos disparados sobre una determinada integración, incluyendo métricas de entrega y análisis en caso de que esta falle, para poder así implementar mejoras. | N/A | Múestrame un resumen de mi historial de notificaciones para validar el funcionamiento de mi sistema de Webhooks. |
create_test_user | Crea usuarios de prueba con credenciales asignadas y dinero disponible para probar flujos de pago. | -site_id (string, requerido): ID del sitio/país para el que se crea la cuenta de prueba. Puede ser: MLA (Argentina), MLB (Brasil), MLC (Chile), MLM (México), MLU (Uruguay), MPE (Perú), MCO (Colombia) - description (string, requerido): Descripción o nombre del usuario de prueba.- profile (string, requerido): Tipo de perfil, que puede ser vendedor (seller), comprador (buyer), o integrador (integrator). - amount (number, opcional): Monto de dinero inicial asignado al usuario, que será validado y ajustado según los límites específicos de cada país. Si no es enviado, se asignará 1000 por defecto. | Crea un usuario de prueba de Mercado Pago para Argentina (MLA) con perfil de vendedor (seller), con la descripción 'Usuario vendedor para pruebas de checkout' y un saldo inicial de 5000. |
add_money_test_user | Agrega dinero a la cuenta de un usuario de prueba en Mercado Pago para probar flujos de pago. El monto será validado y ajustado según los límites específicos de cada país. | -test_user_id (number, requerido): User ID del usuario de prueba al que se le asignará dinero. - amount (number, requerido): Monto de dinero a agregar, que debe atenerse a los límites establecidos para el país de operación asignado al usuario: para Argentina, México, Chile, Uruguay, Perú y Colombia, debe ser entre 1000 y 50000; para Brasil, entre 100 y 50000 BRL. | Agrega 10000 de saldo a la cuenta del usuario de prueba con el ID {test_user_id}. |
get_credentials | Solo disponible vía OAuth. Devuelve las credenciales (Client ID, Client Secret, Access Token y Public Key de producción y sandbox) de una aplicación de Mercado Pago del usuario autenticado. | -application_id (string, opcional): ID de la aplicación. Si no se informa y el usuario tiene solo una aplicación, devuelve esos datos automáticamente. Si tiene más de una, lista todas y pide que el usuario elija. | Muéstrame las credenciales de mi aplicación {application_id}. |
create_application | Solo disponible vía OAuth. Crea una nueva aplicación de Mercado Pago para el usuario autenticado. Captura el contexto de la conversación: si ya tiene toda la información necesaria, crea la aplicación sin hacer preguntas; si falta algún dato, solicita solo la información faltante. El país (site_id) se detecta automáticamente vía OAuth. | -name (string, requerido): Nombre de la aplicación. Máximo 50 caracteres. - payment_solution (enum, requerido): online_payments o in_person_payments. - product (enum, requerido): checkout_pro, checkout_api, checkout_bricks, subscription, point, qr_code. - platform (enum, opcional): Plataforma de e-commerce (ej: woocommerce, shopify). - api_type (enum, opcional): orders o payments. Solo para checkout_api. - description (string, opcional): Descripción de la aplicación. Máximo 150 caracteres. - website_url (string, opcional): URL del sitio de producción. - redirect_url (string, opcional): URL de callback para OAuth. | Crea una nueva aplicación de Mercado Pago para integrar {producto} en mi e-commerce. |
get_application | Solo disponible vía OAuth. Obtiene información sobre las aplicaciones creadas en una cuenta de Mercado Pago Developers. El usuario puede buscar una aplicación sin necesidad de otros MCPs. Si tiene solo una aplicación, el sistema la detecta automáticamente sin requerir que se informe el application_id. | N/A | Muéstrame mis aplicaciones de Mercado Pago. |
