Servers Playground How we check Submit a server

Velora LATAM Tools

Working · 861 ms

io.github.crossi-dev/latam-toolsv1.0.0

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

Commerce Finance & Payments

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://tools.somosvelora.com/api/mcp/public

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

caja_consultar_saldo

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

This tool takes no arguments.

Velora LATAM Tools MCP server | mcptry

Tools (22)

caja_consultar_saldo

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

find_customer

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

read-only

Argument	Type	Description
name	string	Customer name substring to search (case-insensitive).
phone	string	Customer phone number or partial number to search.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "description": "Customer name substring to search (case-insensitive)."
    },
    "phone": {
      "type": "string",
      "description": "Customer phone number or partial number to search."
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_package_profile

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

read-only

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "saleId": {
      "type": "string",
      "description": "Velora Sale ID (takes priority over productIds)."
    },
    "productIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of Velora Product IDs (assumes qty=1 per id)."
    },
    "weightGramsOverride": {
      "type": "number",
      "description": "Explicit weight override in grams.",
      "exclusiveMinimum": 0
    }
  }
}

get_payment_intent_status

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

read-only

Argument	Type	Description
customerName	string	Customer name (fuzzy match).
paymentIntentId	string	Velora PaymentIntent id. Optional when customerName is provided.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "customerName": {
      "type": "string",
      "description": "Customer name (fuzzy match)."
    },
    "paymentIntentId": {
      "type": "string",
      "description": "Velora PaymentIntent id. Optional when customerName is provided."
    }
  }
}

list_suppliers

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

read-only

Argument	Type	Description
search	string	Optional name substring to filter suppliers.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional name substring to filter suppliers."
    }
  }
}

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.

read-only

Argument	Type	Description
defaultTab	string	Optional fullscreen tab to open into.
customerName	string	Optional customer name to pre-search on the Cliente 360 tab.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "defaultTab": {
      "enum": [
        "cliente_360",
        "cierre_dia",
        "reposicion_stock",
        "dashboard_ventas"
      ],
      "type": "string",
      "description": "Optional fullscreen tab to open into."
    },
    "customerName": {
      "type": "string",
      "description": "Optional customer name to pre-search on the Cliente 360 tab."
    }
  }
}

open_caja_status

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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

read-only

Argument	Type	Description
search	string	Optional name filter (case-insensitive substring match).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional name filter (case-insensitive substring match)."
    }
  }
}

open_cobro_status

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

read-only

Argument	Type	Description
customerName	string	Customer name (optional when paymentIntentId is provided).
paymentIntentId	string	Velora PaymentIntent id (optional when customerName is provided).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "customerName": {
      "type": "string",
      "description": "Customer name (optional when paymentIntentId is provided)."
    },
    "paymentIntentId": {
      "type": "string",
      "description": "Velora PaymentIntent id (optional when customerName is provided)."
    }
  }
}

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.

read-only

Argument	Type	Description
saleId	string	Velora Sale id (optional).
customerName	string	Customer name (optional).
paymentIntentId	string	Velora PaymentIntent id (optional).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "saleId": {
      "type": "string",
      "description": "Velora Sale id (optional)."
    },
    "customerName": {
      "type": "string",
      "description": "Customer name (optional)."
    },
    "paymentIntentId": {
      "type": "string",
      "description": "Velora PaymentIntent id (optional)."
    }
  }
}

open_onboarding

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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

read-only

Argument	Type	Description
items*	array	Line items (productId + quantity).
customerId	string	Customer ID (optional).
description*	string	Cobro description (e.g. '3 alfajores').

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "description",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Units.",
            "exclusiveMinimum": 0
          },
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "Product ID."
          },
          "unitPriceOverride": {
            "type": "number",
            "description": "Optional negotiated unit price.",
            "exclusiveMinimum": 0
          }
        }
      },
      "minItems": 1,
      "description": "Line items (productId + quantity)."
    },
    "customerId": {
      "type": "string",
      "minLength": 1,
      "description": "Customer ID (optional)."
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "description": "Cobro description (e.g. '3 alfajores')."
    }
  }
}

open_pending_orders

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

read-only

Argument	Type	Description
items*	array	Line items for the sale.
customerId	string	Optional customer ID (omit for anonymous sales).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Units to sell.",
            "exclusiveMinimum": 0
          },
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "Product ID."
          }
        }
      },
      "maxItems": 500,
      "minItems": 1,
      "description": "Line items for the sale."
    },
    "customerId": {
      "type": "string",
      "description": "Optional customer ID (omit for anonymous sales)."
    }
  }
}

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.

read-only

Argument	Type	Description
items*	array	Line items to prepare for shipment.
declaredValue	number	Declared value in ARS for insurance.
originPostalCode*	string	Origin postal code (4 digits).
destinationPostalCode*	string	Destination postal code (4 digits).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items",
    "originPostalCode",
    "destinationPostalCode"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 9007199254740991,
            "description": "Units.",
            "exclusiveMinimum": 0
          },
          "productId": {
            "type": "string",
            "minLength": 1,
            "description": "Product ID."
          }
        }
      },
      "minItems": 1,
      "description": "Line items to prepare for shipment."
    },
    "declaredValue": {
      "type": "number",
      "minimum": 0,
      "description": "Declared value in ARS for insurance."
    },
    "originPostalCode": {
      "type": "string",
      "description": "Origin postal code (4 digits)."
    },
    "destinationPostalCode": {
      "type": "string",
      "description": "Destination postal code (4 digits)."
    }
  }
}

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.

read-only

Argument	Type	Description
search	string	Optional name filter (case-insensitive substring match).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "description": "Optional name filter (case-insensitive substring match)."
    }
  }
}

query_sales

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

read-only

Argument	Type	Description
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.
metrica*	string	Metric to query.
customer_name	string	Customer name or fragment. Only for historial_cliente.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "metrica"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date YYYY-MM-DD. Requires 'from'."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date YYYY-MM-DD. Requires 'to'."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Max results (default 10, max 50)."
    },
    "preset": {
      "enum": [
        "hoy",
        "semana",
        "mes"
      ],
      "type": "string",
      "description": "Preset date range. Mutually exclusive with from/to."
    },
    "metrica": {
      "enum": [
        "ventas_periodo",
        "margen",
        "ranking_productos",
        "por_empleado",
        "historial_cliente"
      ],
      "type": "string",
      "description": "Metric to query."
    },
    "customer_name": {
      "type": "string",
      "minLength": 1,
      "description": "Customer name or fragment. Only for historial_cliente."
    }
  }
}

quote_shipping

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

read-only

Argument	Type	Description
weightGrams*	number	Total shipment weight in grams.
declaredValue	number	Declared value in ARS for insurance.
originPostalCode*	string	Origin postal code (4 digits).
destinationPostalCode*	string	Destination postal code (4 digits).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "originPostalCode",
    "destinationPostalCode",
    "weightGrams"
  ],
  "properties": {
    "weightGrams": {
      "type": "number",
      "description": "Total shipment weight in grams.",
      "exclusiveMinimum": 0
    },
    "declaredValue": {
      "type": "number",
      "minimum": 0,
      "description": "Declared value in ARS for insurance."
    },
    "originPostalCode": {
      "type": "string",
      "description": "Origin postal code (4 digits)."
    },
    "destinationPostalCode": {
      "type": "string",
      "description": "Destination postal code (4 digits)."
    }
  }
}

track_shipment

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

read-only

Argument	Type	Description
provider*	string	Courier that created the shipment ('andreani', 'oca').
trackingNumber*	string	Tracking number returned by the courier at shipment creation time.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trackingNumber",
    "provider"
  ],
  "properties": {
    "provider": {
      "type": "string",
      "description": "Courier that created the shipment ('andreani', 'oca')."
    },
    "trackingNumber": {
      "type": "string",
      "description": "Tracking number returned by the courier at shipment creation time."
    }
  }
}

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.

read-only

Argument	Type	Description
cuit*	string	CUIT/CUIL in any format (digits, hyphens, or spaces).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cuit"
  ],
  "properties": {
    "cuit": {
      "type": "string",
      "description": "CUIT/CUIL in any format (digits, hyphens, or spaces)."
    }
  }
}