MCPサーバー

Velora LATAM Tools

io.github.crossi-dev/latam-tools

このMCPでできること

Supports Argentine retail operations with customer, catalog, sales, inventory, cash-register, payment, shipping, supplier, delivery, and CUIT validation tools.

caja_consultar_saldo
Consult cash balance
Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
connection_status
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
find_customer
Find customer
Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.
読み取り専用 冪等
入力スキーマ
{'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
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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_package_profile
Get package profile
Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.
読み取り専用 冪等
入力スキーマ
{'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
Get payment intent status
Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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
List suppliers
Returns all suppliers for this business (up to 50, sorted by name).
読み取り専用 冪等
入力スキーマ
{'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
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.
読み取り専用 冪等
入力スキーマ
{'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
Open caja status
Opens a visual widget showing the current shift state and action buttons. Read-only here.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
open_catalog_selector
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).
読み取り専用 冪等
入力スキーマ
{'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
Open cobro status
Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.
読み取り専用 冪等
入力スキーマ
{'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
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.
読み取り専用 冪等
入力スキーマ
{'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
Open onboarding hub
Opens a graphical onboarding hub showing integration status and connect links. Read-only.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
open_payment_link_wizard
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).
読み取り専用 冪等
入力スキーマ
{'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
Open pending orders
Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
open_sale_confirm
Open sale confirmation
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.
読み取り専用 冪等
入力スキーマ
{'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
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.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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
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.
読み取り専用 冪等
入力スキーマ
{'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
Query sales
Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.
読み取り専用 冪等
入力スキーマ
{'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
Quote shipping
Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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
Track shipment
Tracks the current status and event history of a shipment by tracking number.
読み取り専用 外部アクセスあり 冪等
入力スキーマ
{'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
Validate CUIT/CUIL
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.
読み取り専用 冪等
入力スキーマ
{'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).'}}}
追加
open_shipment_prep
2026年9月17日12:41
追加
open_business_overview
2026年9月17日12:41
追加
open_onboarding
2026年9月17日12:41
追加
open_caja_status
2026年9月17日12:41
追加
open_sale_confirm
2026年9月17日12:41
追加
query_sales
2026年9月17日12:41
追加
list_suppliers
2026年9月17日12:41
追加
open_delivery_receipt
2026年9月17日12:41
追加
open_cobro_status
2026年9月17日12:41
追加
open_pending_orders
2026年9月17日12:41
追加
open_payment_link_wizard
2026年9月17日12:41
追加
get_payment_intent_status
2026年9月17日12:41
追加
caja_consultar_saldo
2026年9月17日12:41
追加
connection_status
2026年9月17日12:41
追加
get_package_profile
2026年9月17日12:41
追加
track_shipment
2026年9月17日12:41
追加
quote_shipping
2026年9月17日12:41
追加
find_customer
2026年9月17日12:41
追加
open_catalog_selector
2026年9月17日12:41
追加
query_catalog
2026年9月17日12:41
追加
get_fiscal_readiness
2026年9月17日12:41
追加
validate_cuit
2026年9月17日12:41