Velora LATAM Tools

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Velora LATAM Tools": {
      "url": "https://tools.somosvelora.com/api/mcp/public",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• validate_cuit read-only

  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.

  Parameters:

  • cuit (required) — string — CUIT/CUIL in any format (digits, hyphens, or spaces).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_fiscal_readiness read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• query_catalog read-only

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

  Parameters:

  • search — string — Optional name filter (case-insensitive substring match).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_catalog_selector read-only

  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).

  Parameters:

  • search — string — Optional name filter (case-insensitive substring match).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_customer read-only

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

  Parameters:

  • name — string — Customer name substring to search (case-insensitive).
  • phone — string — Customer phone number or partial number to search.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• quote_shipping read-only

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

  Parameters:

  • originPostalCode (required) — string — Origin postal code (4 digits).
  • destinationPostalCode (required) — string — Destination postal code (4 digits).
  • weightGrams (required) — number — Total shipment weight in grams.
  • declaredValue — number — Declared value in ARS for insurance.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• track_shipment read-only

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

  Parameters:

  • trackingNumber (required) — string — Tracking number returned by the courier at shipment creation time.
  • provider (required) — string — Courier that created the shipment ('andreani', 'oca').

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_package_profile read-only

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

  Parameters:

  • saleId — string — Velora Sale ID (takes priority over productIds).
  • productIds — array — Array of Velora Product IDs (assumes qty=1 per id).
  • weightGramsOverride — number — Explicit weight override in grams.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• connection_status read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• caja_consultar_saldo read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_payment_intent_status read-only

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

  Parameters:

  • customerName — string — Customer name (fuzzy match).
  • paymentIntentId — string — Velora PaymentIntent id. Optional when customerName is provided.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• open_payment_link_wizard read-only

  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).

  Parameters:

  • description (required) — string — Cobro description (e.g. '3 alfajores').
  • items (required) — array — Line items (productId + quantity).
  • customerId — string — Customer ID (optional).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_pending_orders read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_cobro_status read-only

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

  Parameters:

  • customerName — string — Customer name (optional when paymentIntentId is provided).
  • paymentIntentId — string — Velora PaymentIntent id (optional when customerName is provided).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_delivery_receipt read-only

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

  Parameters:

  • saleId — string — Velora Sale id (optional).
  • customerName — string — Customer name (optional).
  • paymentIntentId — string — Velora PaymentIntent id (optional).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_suppliers read-only

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

  Parameters:

  • search — string — Optional name substring to filter suppliers.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• query_sales read-only

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

  Parameters:

  • metrica (required) — string — Metric to query.
  • to — string — End date YYYY-MM-DD. Requires 'from'.
  • from — string — Start date YYYY-MM-DD. Requires 'to'.
  • limit — integer — Max results (default 10, max 50).
  • preset — string — Preset date range. Mutually exclusive with from/to.
  • customer_name — string — Customer name or fragment. Only for historial_cliente.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_sale_confirm read-only

  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.

  Parameters:

  • items (required) — array — Line items for the sale.
  • customerId — string — Optional customer ID (omit for anonymous sales).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_caja_status read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_onboarding read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_business_overview read-only

  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.

  Parameters:

  • defaultTab — string — Optional fullscreen tab to open into.
  • customerName — string — Optional customer name to pre-search on the Cliente 360 tab.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• open_shipment_prep read-only

  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.

  Parameters:

  • items (required) — array — Line items to prepare for shipment.
  • originPostalCode (required) — string — Origin postal code (4 digits).
  • destinationPostalCode (required) — string — Destination postal code (4 digits).
  • declaredValue — number — Declared value in ARS for insurance.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.