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.

limit

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.

nippy_center_id

string

predeterminado:"''"

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

limit

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.

limit

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.

date_from

string

predeterminado:"''"

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

date_to

string

predeterminado:"''"

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

limit

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.

limit

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.

name

string

requerido

Nombre del Nippy Center.

address

string

predeterminado:"''"

Dirección física del centro.

lat

float

predeterminado:"0.0"

Latitud para Google Maps.

long

float

predeterminado:"0.0"

Longitud para Google Maps.

google_maps_link

string

predeterminado:"''"

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

active_member_duration

integer

predeterminado:"30"

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

non_member_duration

integer

predeterminado:"15"

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

capacity

integer

predeterminado:"50"

Capacidad máxima del centro.

country_id

string

predeterminado:"''"

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

type

string

predeterminado:"'physical'"

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

is_active

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.

product_name

string

requerido

Nombre del producto.

total_stock

integer

requerido

Cantidad total de stock inicial.

min_stock_alert

integer

requerido

Umbral mínimo para alertas de bajo inventario.

type

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.

stock_id

string

requerido

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

nippy_center_id

string

requerido

ID del Nippy Center (de list_nippy_centers).

current_stock

integer

requerido

Cantidad de stock a asignar al centro.

min_stock_alert

integer

requerido

Umbral mínimo para alertas en este centro.

criticality

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

stock_id

string

requerido

ID del producto a retirar.

nippy_center_id

string

requerido

ID del Nippy Center de donde se retira.

worker_id

string

requerido

ID del trabajador que recibe el retiro.

string

requerido

Email del trabajador.

quantity

integer

requerido

Cantidad a retirar.

withdrawal_type

string

predeterminado:"'insumos'"

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

entregador

string

predeterminado:"''"

Nombre del entregador. Opcional.

tipo_entrega

string

predeterminado:"''"

Tipo de entrega. Opcional.

ciudad

string

predeterminado:"''"

Ciudad. Opcional.

talla

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

Inicio

SDK

MCP

Documentation Index

​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