Introducción

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.

Nuestro Remote MCP Server mantiene las mismas funcionalidades disponibles en la API, excepto acciones que eliminan registros.