nortex-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HTTP_HOST | No | Host/interface for the Streamable HTTP transport. Defaults to loopback. | 127.0.0.1 |
| MCP_HTTP_PORT | No | Port for the Streamable HTTP transport. | 8931 |
| MCP_TRANSPORT | No | Transport to use. Set to "http" to enable Streamable HTTP; default is stdio. | stdio |
| NORTEX_API_URL | No | Base URL of the Nortex monolith/API. Required when NORTEX_API_MODE=http or when client auth mode is enabled. | |
| NORTEX_API_MODE | No | Set to "http" to use the real Nortex backend instead of the default stdio mock mode. Requires NORTEX_API_URL and NORTEX_SERVICE_TOKEN. | mock |
| NORTEX_TENANT_ID | No | Tenant/session label used for rate limiting and audit logging in ops/stdio mode. Not settable by tool calls. | default |
| NORTEX_SERVICE_TOKEN | No | Service token used to authenticate to the Nortex backend when NORTEX_API_MODE=http. Read only from the environment; never logged. | |
| NORTEX_MCP_HTTP_TOKEN | No | Bearer token for operator/ops mode over Streamable HTTP. Required for HTTP ops mode unless NORTEX_MCP_CLIENT_AUTH is enabled. | |
| NORTEX_MCP_CLIENT_AUTH | No | Set to "1", "true", or "on" to enable client auth mode. In this mode, NORTEX_API_URL is required and clients authenticate per request with a Nortex JWT or nxt_ AI-access token. | off |
| NORTEX_RATE_LIMIT_PER_MIN | No | Maximum tool calls per minute per tenant or per tenant+user/opaque token. | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ventas_hoyA | Cuánto vendió el negocio hoy (día comercial America/Managua), en voseo listo para voz. |
| buscar_productoB | Busca productos por nombre. Devuelve precio y stock por bodega, en voseo. |
| stock_productoA | Cuánto stock queda de un producto, total y por bodega, en voseo. |
| ventas_periodoB | Ventas de los últimos N días (1-30, default 7) con el mejor día, en voseo. |
| inventario_bajoB | Productos con stock bajo (punto de reorden o umbral dado), en voseo. |
| estado_conteoB | Conteos de inventario abiertos (qué bodega, cuánto llevan contado), en voseo. |
| precio_productoB | Precio base (NIO) de un producto, en voseo. El precio en USD vive en T6 (precio_dolares). |
| detalle_ventaA | Detalle de una factura por su referencia (ej. A-15): total, líneas con cantidades y precios, cliente y cómo pagó. Busca en los últimos 31 días. |
| informe_ventasA | Informe integral de ventas a pedido: consolidado del período (ventas brutas/netas, IVA, utilidad bruta, ticket promedio), cómo pagaron y los productos que más se venden y más utilidad dejan, ordenados. Resumen en voseo listo para voz + detalle en texto. |
| resolver_dudaA | Responde dudas de USO de Nortex (cómo se hace algo en la app: vender por caja, códigos de barras, regalías, lotes, anulaciones, etc.) con fuentes oficiales: el Manual de Usuario y casos verificados contra el código. Devuelve respuesta breve en voseo + fuente + confianza; si ninguna fuente respalda, dice explícitamente 'Sin fundamento en el manual'. Solo conocimiento: no lee ni toca datos del negocio. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Tools are mostly distinct by resource and intent, with clear descriptions separating sales queries (today vs period vs report) and product lookups. Minor overlap: buscar_producto already returns price and stock, making stock_producto and precio_producto somewhat redundant, but each has a specific use case.
All names are snake_case in Spanish, but the pattern mixes verb-first (buscar_producto, resolver_duda) and noun-first (ventas_hoy, stock_producto) conventions. Still readable, but not a consistent verb_noun pattern.
10 tools is well within the ideal range for a business analytics assistant. Each tool covers a distinct query type (sales, product, stock, inventory, help) without excessive granularity.
Covers core sales and inventory queries, but notable gaps remain: no way to query sales for a specific product over time, no customer-level sales history, no data on voided/returned sales, and historical sales limited to 30 days. Agents may hit dead ends for common follow-up questions.