ASPEL SAE MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SAE_HOST | Yes | The host of the Firebird server. | |
| SAE_PORT | Yes | The port of the Firebird server. | |
| SAE_USER | Yes | Firebird username. | |
| SAE_CHARSET | Yes | Character set for the connection (e.g. WIN1252 or ISO8859_1). | |
| SAE_VERSION | Yes | ASPEL SAE version (8 or 10). | |
| SAE_PASSWORD | Yes | Firebird password. | |
| SAE_LOG_LEVEL | No | Logging level (e.g. DEBUG, INFO, WARNING, ERROR). | INFO |
| SAE_DATABASE_PATH | Yes | Path to the ASPEL SAE database file (.FDB), e.g. 'C:/Program Files (x86)/Common Files/Aspel/Sistemas Aspel/SAE 10.00/Datos/Empresa01/SAE100EMPRE01.FDB'. | |
| SAE_DEFAULT_EMPRESA | Yes | Default company number (01 to 99). |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_warehousesA | Lista todos los almacenes registrados en ASPEL SAE (tabla ALMACENES). Args: empresa: Clave de empresa a consultar (ej. '01'). Si se omite, usa la predeterminada. |
| get_stock_by_warehouseA | Consulta las existencias y stocks mínimo/máximo de un producto en un almacén específico o en todos. Cruza la tabla MULT[EE] con ALMACENES[EE]. Args: cve_art: Clave del artículo en el catálogo de SAE. cve_alm: Clave numérica del almacén (opcional). Si no se indica, regresa el stock en todos los almacenes. empresa: Clave de empresa (opcional). |
| get_warehouse_summaryB | Obtiene un resumen cuantitativo y alertas de un almacén: total de artículos, piezas acumuladas y conteo/lista de artículos con existencia por debajo del stock mínimo. Args: cve_alm: Clave numérica del almacén. empresa: Clave de empresa (opcional). |
| get_product_kardexA | Consulta el historial de movimientos de inventario (Kardex en MINVE[EE]) de un producto. Permite auditar entradas, salidas por ventas, compras o traspasos entre almacenes. Args: cve_art: Clave del artículo. cve_alm: Filtrar movimientos de un almacén particular (opcional). fecha_inicio: Fecha filtro inicial en formato 'YYYY-MM-DD' o 'DD.MM.YYYY' (opcional). limit: Cantidad máxima de movimientos a retornar (máx 200). empresa: Clave de empresa (opcional). |
| search_productsB | Busca productos en el catálogo de ASPEL SAE por clave o descripción. Incluye el desglose de existencias por almacén si el producto maneja multialmacén. Args: query: Término de búsqueda (clave o texto descriptivo). cve_alm: Filtrar únicamente productos que tengan stock > 0 en este almacén (opcional). linea: Filtrar por línea de producto (opcional). status: 'A' (Activo), 'B' (Baja), 'S' (Suspendido). Default 'A'. limit: Cantidad máxima de artículos a retornar (máx 100). empresa: Clave de empresa (opcional). |
| get_product_detailB | Obtiene la ficha técnica completa de un artículo, incluyendo si maneja multialmacén (CON_CTRL_ALM) y las existencias detalladas en cada almacén activo. Args: cve_art: Clave del artículo. empresa: Clave de empresa (opcional). |
| get_document_detailsA | Consulta un documento comercial (factura, pedido, remisión o cotización) y el desglose de sus partidas, identificando de qué almacén (NUM_ALM) proviene o fue asignada cada mercancía. Args: cve_doc: Folio del documento (ej. '1024' o 'A1024'). tipo_doc: Tipo de documento: 'factura', 'pedido', 'remision' o 'cotizacion'. empresa: Clave de empresa (opcional). |
| get_client_infoC | Consulta los datos comerciales, RFC, dirección, saldo y límite de crédito de un cliente (CLIE). Args: clave_cliente: Clave del cliente en Aspel SAE. empresa: Clave de empresa (opcional). |
| explain_sae_tableA | Explica la estructura, propósito de negocio, campos clave y relaciones de una tabla de Aspel SAE. Útil para comprender tablas como MULT, INVE, ALMACENES, MINVE, FACTF, etc. Args: table_name: Nombre de la tabla (ej. 'MULT', 'INVE', 'ALMACENES', 'MINVE', 'FACTF'). |
| query_sae_read_onlyA | Ejecuta una consulta SQL SELECT arbitraria de SOLO LECTURA sobre la base de datos Firebird 2.5. PROTECCIONES AUTOMÁTICAS:
Args: sql_query: Sentencia SELECT a ejecutar. max_rows: Límite de filas (máx 200 por defecto). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_warehouses | Retorna el catálogo completo de almacenes físicos y lógicos de la empresa predeterminada. |
| resource_schema_dictionary | Retorna el diccionario de tablas y relaciones de ASPEL SAE con soporte multialmacén. |
| resource_company_info | Retorna la configuración actual del servidor MCP y parámetros de Aspel SAE. |
TDQS
Scored across 10 tools
Most tools have distinct resource+action targets. Some overlap exists among get_stock_by_warehouse, get_product_detail, and search_products because all expose stock data, but the descriptions make the intended use identifiable.
All tool names follow a consistent snake_case verb_noun pattern such as list_warehouses, get_product_kardex, and search_products. The occasional preposition like by_warehouse is still readable and does not break the overall pattern.
Ten tools is well-scoped for an ERP-focused MCP server covering warehouse, product, document, client, and schema lookup. Each tool has a clear role and none feel redundant.
The read-only inventory domain is well covered: warehouses, stock, kardex, product search/detail, documents, clients, and table exploration. The main gap is the lack of direct list endpoints, but query_sae_read_only and explain_sae_table provide a workaround.