Nippy API Platform

Ejemplos de lo que puedes preguntarle a tu agente

“¿Qué productos tengo en inventario y cuántos quedan de cada uno?”
“¿Hay algo por debajo del stock mínimo? Avísame qué urge reponer”
“Muéstrame los centros de distribución que tengo y qué hay en cada uno”
“Registra una entrega de 3 uniformes a Carlos en el centro de Guadalajara”
“¿Cuántos retiros hubo en abril? Dame el historial completo”

Supply te deja manejar todo tu inventario desde el chat. Consultas lo que hay, recibes alertas cuando algo se está acabando y registras movimientos. Las operaciones que modifican datos (crear centros, asignar stock, registrar retiros) siempre te muestran un preview antes de ejecutarse — nada se escribe sin que confirmes.

Tools de lectura

`supply_list_stocks`

Lista el catálogo global de productos (stock) de este negocio.

integer

predeterminado:"100"

Número máximo de items a retornar.

Respuesta incluye: _id, productName, totalStock, minStockAlert, type, createdAt

{
  "name": "supply_list_stocks",
  "arguments": {
    "limit": 50
  }
}

`supply_list_nippy_center_stocks`

Lista los niveles de stock por Nippy Center. Opcionalmente filtra por un centro específico.

string

predeterminado:"''"

ID del Nippy Center. Si se omite, retorna todos los centros del negocio.

integer

predeterminado:"100"

Número máximo de items a retornar.

Respuesta incluye: _id, stockId, nippyCenterId, currentStock, minStockAlert, criticality, productName

{
  "name": "supply_list_nippy_center_stocks",
  "arguments": {
    "nippy_center_id": "64aed18101d27bba60dce608",
    "limit": 100
  }
}

`supply_get_low_stock_alerts`

Lista todos los items donde el stock actual está por debajo del umbral mínimo configurado.

integer

predeterminado:"100"

Número máximo de alertas a retornar.

Respuesta incluye: items con currentStock < minStockAlert, con productName joineado del catálogo.

{
  "name": "supply_get_low_stock_alerts",
  "arguments": {
    "limit": 20
  }
}

`supply_get_withdrawal_history`

Lista el historial de retiros de supply para este negocio en un rango de fechas.

string

predeterminado:"''"

Fecha de inicio en formato ISO 8601, e.g. "2026-01-01". Opcional.

string

predeterminado:"''"

Fecha de fin en formato ISO 8601, e.g. "2026-05-08". Opcional.

integer

predeterminado:"50"

Número máximo de retiros a retornar.

{
  "name": "supply_get_withdrawal_history",
  "arguments": {
    "date_from": "2026-05-01",
    "date_to": "2026-05-08",
    "limit": 100
  }
}

`supply_list_nippy_centers`

Lista los Nippy Centers (puntos de distribución) del negocio.

integer

predeterminado:"100"

Número máximo de centros a retornar.

Respuesta incluye: _id, name, address, geo, capacity, schedule, isActive, type

{
  "name": "supply_list_nippy_centers",
  "arguments": {
    "limit": 50
  }
}

Tools de escritura — Nippy Centers

`supply_propose_nippy_center`

Genera un preview del Nippy Center antes de crearlo. No escribe a la base de datos.

string

requerido

Nombre del Nippy Center.

string

predeterminado:"''"

Dirección física del centro.

float

predeterminado:"0.0"

Latitud para Google Maps.

float

predeterminado:"0.0"

Longitud para Google Maps.

string

predeterminado:"''"

URL de Google Maps. Si se omite, se genera automáticamente a partir de lat/long.

integer

predeterminado:"30"

Duración de la cita para miembros activos (minutos).

integer

predeterminado:"15"

Duración de la cita para no miembros (minutos).

integer

predeterminado:"50"

Capacidad máxima del centro.

string

predeterminado:"''"

ID del país. Si se omite, usa el default del negocio.

string

predeterminado:"'physical'"

Tipo de centro: "physical" u "online".

boolean

predeterminado:"true"

Si el centro está activo.

{
  "name": "supply_propose_nippy_center",
  "arguments": {
    "name": "Centro Norte CDMX",
    "address": "Av. Insurgentes 123, CDMX",
    "lat": 19.4326,
    "long": -99.1332,
    "capacity": 80,
    "type": "physical"
  }
}

`supply_create_nippy_center`

Crea el Nippy Center en la base de datos. Mismos parámetros que propose_nippy_center.

Solo llama esta tool después de mostrar al usuario el preview de propose_nippy_center y recibir confirmación explícita.

Respuesta: {"_id": "...", "name": "Centro Norte CDMX", "status": "created"}

Tools de escritura — Stock global

`supply_propose_stock`

Genera un preview del producto de stock antes de crearlo. No escribe a la base de datos.

string

requerido

Nombre del producto.

integer

requerido

Cantidad total de stock inicial.

integer

requerido

Umbral mínimo para alertas de bajo inventario.

string

predeterminado:"''"

Categoría del producto, e.g. "insumo", "premio", "uniforme". Opcional.

{
  "name": "supply_propose_stock",
  "arguments": {
    "product_name": "Mochila Nippy 2026",
    "total_stock": 500,
    "min_stock_alert": 50,
    "type": "premio"
  }
}

`supply_create_stock`

Crea el producto en el catálogo global. Mismos parámetros que propose_stock.

Solo llama esta tool después de mostrar al usuario el preview de propose_stock y recibir confirmación explícita.

Respuesta: {"_id": "...", "productName": "Mochila Nippy 2026", "status": "created"}

Tools de escritura — Stock por Nippy Center

`supply_propose_nippy_center_stock`

Genera un preview de la asignación de stock a un Nippy Center. No escribe a la base de datos.

string

requerido

ID del producto del catálogo global (de list_stocks).

string

requerido

ID del Nippy Center (de list_nippy_centers).

integer

requerido

Cantidad de stock a asignar al centro.

integer

requerido

Umbral mínimo para alertas en este centro.

string

predeterminado:"''"

Nivel de criticidad: "low", "medium", "high". Opcional.

{
  "name": "supply_propose_nippy_center_stock",
  "arguments": {
    "stock_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "nippy_center_id": "64aed18101d27bba60dce608",
    "current_stock": 100,
    "min_stock_alert": 10,
    "criticality": "high"
  }
}

`supply_create_nippy_center_stock`

Asigna stock a un Nippy Center. Mismos parámetros que propose_nippy_center_stock.

Valida que tanto el stock como el centro pertenezcan al negocio antes de escribir.

Respuesta: {"_id": "...", "status": "created"}

Tools de escritura — Retiros

`supply_propose_withdrawal`

Genera un preview del retiro y valida la disponibilidad de stock. No escribe a la base de datos. Verifica que:

El Nippy Center pertenece al negocio
El stock pertenece al negocio
Hay suficiente stock en el centro para la cantidad solicitada

string

requerido

ID del producto a retirar.

string

requerido

ID del Nippy Center de donde se retira.

string

requerido

ID del trabajador que recibe el retiro.

string

requerido

Email del trabajador.

integer

requerido

Cantidad a retirar.

string

predeterminado:"'insumos'"

Tipo de retiro. Consulta nippy://supply/schema/withdrawals para los tipos disponibles.

string

predeterminado:"''"

Nombre del entregador. Opcional.

string

predeterminado:"''"

Tipo de entrega. Opcional.

string

predeterminado:"''"

Ciudad. Opcional.

string

predeterminado:"''"

Talla (para uniformes u otros items con talla). Opcional.

{
  "name": "supply_propose_withdrawal",
  "arguments": {
    "stock_id": "664f1a2b3c4d5e6f7a8b9c0d",
    "nippy_center_id": "64aed18101d27bba60dce608",
    "worker_id": "665c8d4e5f6a7b8c9d0e1f2a",
    "email": "trabajador@nippy.la",
    "quantity": 2,
    "withdrawal_type": "insumos"
  }
}

`supply_approve_withdrawal`

Ejecuta el retiro. Decrementa el stock en el Nippy Center y registra la entrega. Mismos parámetros que propose_withdrawal.

Solo llama esta tool después de mostrar el preview de propose_withdrawal y recibir confirmación explícita. Esta operación es atómica e irreversible.

Respuesta: {"_id": "...", "status": "created"}

Flujo completo de retiro

supply_list_nippy_centers          → obtener IDs de centros
supply_list_stocks                 → obtener IDs de productos
supply_list_nippy_center_stocks    → verificar stock disponible en el centro
supply_propose_withdrawal          → preview + validación de disponibilidad
[usuario confirma]
supply_approve_withdrawal          → ejecutar retiro (decrementa stock + crea registro)

Detalles técnicos (avanzado)

Referencias de esquemas para el agente:

URI	Nombre	Descripción
`nippy://supply/schema/stock`	`supply_stock_schema`	Campos de stock global y stock por centro
`nippy://supply/schema/withdrawals`	`supply_withdrawal_schema`	Tipos de retiro y reglas de flujo
`nippy://supply/schema/centers`	`supply_nippy_center_schema`	Campos de Nippy Center y scheduling

Inicio

SDK

MCP

Supply

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`supply_list_stocks`

`supply_list_nippy_center_stocks`

`supply_get_low_stock_alerts`

`supply_get_withdrawal_history`

`supply_list_nippy_centers`

Tools de escritura — Nippy Centers

`supply_propose_nippy_center`

`supply_create_nippy_center`

Tools de escritura — Stock global

`supply_propose_stock`

`supply_create_stock`

Tools de escritura — Stock por Nippy Center

`supply_propose_nippy_center_stock`

`supply_create_nippy_center_stock`

Tools de escritura — Retiros

`supply_propose_withdrawal`

`supply_approve_withdrawal`

Flujo completo de retiro

​Ejemplos de lo que puedes preguntarle a tu agente

​Tools de lectura

​supply_list_stocks

​supply_list_nippy_center_stocks

​supply_get_low_stock_alerts

​supply_get_withdrawal_history

​supply_list_nippy_centers

​Tools de escritura — Nippy Centers

​supply_propose_nippy_center

​supply_create_nippy_center

​Tools de escritura — Stock global

​supply_propose_stock

​supply_create_stock

​Tools de escritura — Stock por Nippy Center

​supply_propose_nippy_center_stock

​supply_create_nippy_center_stock

​Tools de escritura — Retiros

​supply_propose_withdrawal

​supply_approve_withdrawal

​Flujo completo de retiro

Ejemplos de lo que puedes preguntarle a tu agente

Tools de lectura

`supply_list_stocks`

`supply_list_nippy_center_stocks`

`supply_get_low_stock_alerts`

`supply_get_withdrawal_history`

`supply_list_nippy_centers`

Tools de escritura — Nippy Centers

`supply_propose_nippy_center`

`supply_create_nippy_center`

Tools de escritura — Stock global

`supply_propose_stock`

`supply_create_stock`

Tools de escritura — Stock por Nippy Center

`supply_propose_nippy_center_stock`

`supply_create_nippy_center_stock`

Tools de escritura — Retiros

`supply_propose_withdrawal`

`supply_approve_withdrawal`

Flujo completo de retiro