# Genei

Manage logistics operations by comparing shipping prices and creating shipments across multiple agencies. Track package status in real-time, download labels, and handle cancellations through a unifie…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add genei/shipping

# Browse available tools
npx -y @smithery/cli@latest tool list genei/shipping

# Get full schema for a tool
npx -y @smithery/cli@latest tool get genei/shipping get_shipping_prices

# Call a tool
npx -y @smithery/cli@latest tool call genei/shipping get_shipping_prices '{}'
```

## Direct MCP Connection

Endpoint: `https://shipping--genei.run.tools`

**Optional config:**
- `username` (query) — Tu usuario de Genei.es (email)
- `password` (query) — Tu contraseña de Genei.es

## Tools (13)

- `get_shipping_prices` — Obtiene las opciones de envío disponibles con sus precios para un origen, destino y paquetes dados. Útil para elegir ag…
- `list_agencies` — Lista todas las agencias de transporte disponibles para tu cuenta Genei.
- `create_shipment` — Crea un nuevo envío en Genei. Devuelve un código de referencia (ej: 'GN4ZCOCN') y una URL de pago. El envío nace en est…
- `get_shipment` — Obtiene la información completa de un envío por su código de referencia Genei (ej: 'GN4ZCOCN'). Incluye estado, código …
- `get_shipment_state` — Obtiene el estado actual de un envío. Estados: 7=pendiente de pago, 6=pendiente tramitar, 1=tramitado, 5=en tránsito, 8…
- `cancel_shipment` — Cancela un envío. Solo válido para envíos aún no tramitados con la agencia. Esta acción es irreversible.
- `get_shipment_label` — Descarga la etiqueta de un envío en base64. Soporta PDF (impresoras normales) y ZPL/EPL/DPL (impresoras térmicas) y PNG…
- `get_bulk_labels` — Descarga las etiquetas de múltiples envíos en una sola llamada.
- `get_shipment_tracking` — Obtiene el historial completo de eventos de tracking de un envío: fechas, estados y descripciones registrados por la ag…
- `get_tracking_url` — Obtiene la URL pública de seguimiento del envío para compartir con el destinatario.
- `get_bulk_tracking` — Obtiene el estado y eventos de tracking de múltiples envíos en una sola llamada.
- `list_addresses` — Lista las direcciones guardadas en la cuenta Genei para reutilizarlas en envíos.
- `create_address` — Crea y guarda una nueva dirección en la cuenta Genei para reutilizarla en futuros envíos.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get genei/shipping <tool-name>
```