Introducción

📘

Beta

Esta es una funcionalidad que se encuentra en Beta y que puede cambiar sin previo aviso.

Si quieres acceso a ella, escribe a [email protected] y cuéntanos sobre cómo quieres utilizar Venti en tu agente.

MCP (Model Context Protocol) es un protocolo que estandariza cómo una aplicación le provee contexto a un LLM (Large Language Model).

Venti te ofrece un servidor remote MCP para que conectes tu agente AI y accedas a datos y funciones de tu cuenta de comercio.

Conexión

Nuestro servidor remote MCP se encuentra disponible en https://api.ventipay.com/mcp/merchant/ y soporta el mecanismo de transporte Streamable HTTP exclusivamente.

 Autenticación

Las solicitudes deben autenticarse con tu API Key secreta, la que debes enviar como bearer token.

curl https://api.ventipay.com/mcp/merchant/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API Key>" \
  -d '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "params": {
        "name": "create_checkout_link",
        "arguments": {"amount": 1000, "currency": "clp" }
      },
      "id": 1
  }'

Herramientas disponibles

Para conocer todas las herramientas disponibles, debes utilizar el comando tools/list. Cada herramienta cuenta con un schema que indica su funcionalidad y parámetros requeridos.

create_checkout_link

Esta herramienta te permite crear un link de pago utilizando el objeto Checkout.

La respuesta incluirá un link que podrás compartir con el cliente final para que realice el pago por el monto y moneda indicados.

Usuario:
Le quiero cobrar 5 mil pesos chilenos a [email protected] por un unicornio de juguete.

Agente:
Perfecto! El link para cobrar está [acá](https://ventipay.com/checkout/Checkout ID>)

Parámetros

amount number requerido

Un número entero positivo que representa cuánto cobrar en la unidad monetaria más pequeña (por ejemplo, 100 centavos para cobrar USD $ 1,00 o 100 para cobrar CLP $ 100).

currency string requerido

Código de moneda ISO de tres letras. Corresponde a la moneda de presentación.

description string

Descripción del link de pago.

email string

Email del cliente.

get_sales_analytics

Esta herramienta te permite obtener un resumen de tus ventas.

La respuesta incluirá el monto total vendido por día, además de la moneda, el tipo y marca del método de pago utilizado.

Usuario:
¿Cuánto vendí con tarjeta de débito la semana pasada?

Agente:
La semana pasada vendiste CLP $25.000.000 con tarjeta de débito.

Parámetros

date_start string requerido

Fecha de inicio del rango de la consulta en formato ISO 8601. En huso horario UTC.

date_end string requerido

Fecha de termino del rango de la consulta en formato ISO 8601. En huso horario UTC.