io.github.crossi-dev/latam-tools

Velora LATAM Tools

Argentina CUIT/CUIL validation and AFIP fiscal QR generation. Pure, no-auth MCP tools.

1.0.0
Version
remote
Transport
22
Tools

Security review

Review passed

Reviewed 1h ago.

  • tools: 22 tools scanned
  • metadata: scanned

No findings.

Tools (22)

  • validate_cuit

    Validates an Argentine CUIT or CUIL number. Returns parsed components (prefix, body, check digit), person type, and whether the check digit is mathematically correct. Accepts any format: raw digits, hyphened (20-12345678-9), or spaced. This tool runs the REAL check-digit algorithm — not a demo fixture.

  • get_fiscal_readiness

    Checks whether the business is ready to emit real ARCA electronic invoices. Returns { ready, missing, guidance } where ready=true means all fiscal fields and the ARCA certificate are configured.

  • query_catalog

    Lists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.

  • open_catalog_selector

    Opens the catalog selector — a graphical product picker (MCP Apps widget) that shows active products with prices (ARS) and stock. Side-effect-free (no sale, no charge).

  • find_customer

    Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.

  • quote_shipping

    Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.

  • track_shipment

    Tracks the current status and event history of a shipment by tracking number.

  • get_package_profile

    Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.

  • connection_status

    Returns the BYOA (Bring Your Own Account) integration readiness for the authenticated business — what is connected and how to connect what is missing. Read-only.

  • caja_consultar_saldo

    Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.

  • get_payment_intent_status

    Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.

  • open_payment_link_wizard

    Opens the payment-link wizard — a graphical form pre-filled with the cobro, for the owner to review and confirm before any money moves. Side-effect-free (no charge).

  • open_pending_orders

    Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.

  • open_cobro_status

    Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.

  • open_delivery_receipt

    Opens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.

  • list_suppliers

    Returns all suppliers for this business (up to 50, sorted by name).

  • query_sales

    Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.

  • open_sale_confirm

    Opens a VISUAL preview of a cash sale — resolved product names, unit prices, quantities, and total — with a confirm button that fires register_sale. Read-only preview itself.

  • open_caja_status

    Opens a visual widget showing the current shift state and action buttons. Read-only here.

  • open_onboarding

    Opens a graphical onboarding hub showing integration status and connect links. Read-only.

  • open_business_overview

    ONE widget, two display modes: inline snapshot by default, fullscreen tabs (Cliente 360, Cerrar el día, Reposición de stock, Dashboard de ventas) on demand. Aggregates caja, payments, ventas, reportes, supplier, and customer reads.

  • open_shipment_prep

    Combines catalog stock/weight data and a live shipping quote into one widget — resolves items, computes total weight, and quotes couriers. Read-only, side-effect-free.