Velora Mcp Tools

{"result":{"tools":[{"name":"validate_cuit","title":"Validate CUIT/CUIL","description":"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.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"cuit":{"type":"string","description":"CUIT/CUIL in any format (digits, hyphens, or spaces)."}},"required":["cuit"]},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"get_fiscal_readiness","title":"Get fiscal readiness","description":"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.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"emit_invoice","title":"Emit invoice (ARCA)","description":"[demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"customerCuit":{"type":"string","description":"Customer CUIT/CUIL (11 digits, any format)."},"amountARS":{"type":"number","exclusiveMinimum":0,"description":"Invoice total in Argentine pesos (ARS)."},"tipo":{"type":"string","enum":["A","B","C"],"description":"A = IVA discriminado (B2B), B = consumidor final, C = monotributo."},"concept":{"description":"Items or concept description (optional).","type":"string"},"requestId":{"description":"Optional idempotency nonce.","type":"string"}},"required":["customerCuit","amountARS","tipo"]},"annotations":{"readOnlyHint":false,"idempotentHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"emit_nota","title":"Emit credit/debit note (ARCA)","description":"[demo: deshabilitada] Emits an ARCA-compliant Nota Crédito (NC) or Nota Débito (ND) against an original AFIP invoice and returns the CAE authorization code.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"customerCuit":{"type":"string","description":"Customer CUIT/CUIL (11 digits, any format)."},"amountARS":{"type":"number","exclusiveMinimum":0,"description":"Note total in Argentine pesos (ARS)."},"tipo":{"type":"string","enum":["A","B","C"],"description":"Invoice type letter for this nota."},"kind":{"type":"string","enum":["credito","debito"],"description":"credito = Nota Crédito, debito = Nota Débito."},"associatedInvoice":{"type":"object","properties":{"tipo":{"type":"string","enum":["1","6","11"],"description":"WSFE tipoComprobante of the original factura: 1=A, 6=B, 11=C."},"ptoVta":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Punto de venta of the original invoice."},"nro":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Sequential number of the original invoice."}},"required":["tipo","ptoVta","nro"],"description":"Reference to the original invoice being credited or debited."},"concept":{"description":"Items or concept description (optional).","type":"string"},"requestId":{"description":"Optional idempotency nonce.","type":"string"}},"required":["customerCuit","amountARS","tipo","kind","associatedInvoice"]},"annotations":{"readOnlyHint":false,"idempotentHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"create_product","title":"Create product","description":"[demo: deshabilitada] Creates a new product in the business catalog. Requires name and price.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"name":{"type":"string","minLength":1,"description":"Product name."},"price":{"type":"number","exclusiveMinimum":0,"description":"Selling price in ARS."},"costPrice":{"description":"Purchase cost price in ARS (optional).","type":"number","exclusiveMinimum":0},"weightGrams":{"description":"Weight in grams (optional).","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"initialStock":{"default":0,"description":"Initial stock quantity (default 0).","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["name","price"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"edit_product","title":"Edit product","description":"[demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"productId":{"type":"string","minLength":1,"description":"ID of the product to update."},"name":{"description":"New product name (optional).","type":"string","minLength":1},"price":{"description":"New selling price in ARS (optional).","type":"number","exclusiveMinimum":0},"costPrice":{"description":"New cost price, or null to clear (optional).","anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"stockQuantity":{"description":"Set stock to this value (optional).","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["productId"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"stock_load","title":"Stock load","description":"[demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"productId":{"description":"Existing product ID (optional if itemName resolves it).","type":"string"},"itemName":{"type":"string","minLength":1,"description":"Product name for resolution or auto-creation."},"supplierId":{"description":"Existing supplier ID (optional).","type":"string"},"supplierName":{"description":"Supplier name (optional).","type":"string"},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Units received."},"unitPrice":{"description":"Cost per unit in ARS.","type":"number","minimum":0},"autoCreateProduct":{"default":false,"description":"Auto-create product if not found.","type":"boolean"},"createPurchaseRequest":{"default":false,"description":"Also create a purchase request for this stock load.","type":"boolean"}},"required":["itemName","quantity"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"adjust_stock","title":"Adjust stock","description":"[demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"productId":{"type":"string","minLength":1,"description":"Product ID to update."},"mode":{"type":"string","const":"set","description":"Must be 'set'. Absolute-set is the only mode available via MCP."},"quantity":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"New absolute stock quantity."}},"required":["productId","mode","quantity"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"delete_product","title":"Delete product","description":"[demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"productId":{"type":"string","minLength":1,"description":"ID of the product to delete."}},"required":["productId"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"bulk_price_update","title":"Bulk price update","description":"[demo: deshabilitada] Mass price change for all products or a specified subset in this business.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"amount":{"type":"number","exclusiveMinimum":0,"description":"Adjustment amount — percentage or fixed ARS value depending on mode."},"mode":{"type":"string","enum":["percent","fixed"],"description":"'percent' = percentage change; 'fixed' = absolute ARS change."},"direction":{"type":"string","enum":["up","down","set"],"description":"'up' raises, 'down' lowers, 'set' assigns an exact price."},"productIds":{"description":"Specific product IDs to update. Omit to update ALL products.","type":"array","items":{"type":"string","minLength":1}}},"required":["amount","mode","direction"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"query_catalog","title":"Query catalog","description":"Lists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"search":{"description":"Optional name filter (case-insensitive substring match).","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"open_catalog_selector","title":"Open catalog selector","description":"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).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"search":{"description":"Optional name filter (case-insensitive substring match).","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"register_sale","title":"Register sale","description":"[demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"items":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"description":"Product ID."},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Units sold (positive integer)."},"unitPrice":{"description":"Sale price per unit in ARS (optional; catalog price used when omitted).","type":"number","exclusiveMinimum":0}},"required":["productId","quantity"]},"description":"Line items for the sale."},"customerId":{"description":"Optional customer ID. Omit for anonymous sales.","type":"string"},"paymentMethod":{"description":"Defaults to 'efectivo' when omitted.","type":"string","enum":["efectivo","transferencia","mp","qr","modo"]},"requestId":{"description":"Optional idempotency override.","type":"string"}},"required":["items"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"register_movement","title":"Register cash movement","description":"[demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment').","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"type":{"type":"string","enum":["purchase","tax","salary","adjustment","income","sale"],"description":"Movement type."},"description":{"type":"string","minLength":1,"description":"Description (e.g. 'Pago proveedor Distribuidora ABC')."},"amount":{"type":"number","exclusiveMinimum":0,"description":"Amount in ARS (always positive)."},"date":{"description":"ISO 8601 date/datetime. Defaults to now.","type":"string"}},"required":["type","description","amount"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"return_sale","title":"Return sale","description":"[demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"confirm":{"type":"boolean","const":true,"description":"Must be explicitly true to confirm reversing sales."},"count":{"default":1,"description":"Number of recent sales to reverse (max 10).","type":"integer","exclusiveMinimum":0,"maximum":10},"cutoffHours":{"default":24,"description":"Only consider sales within the last N hours (max 48).","type":"number","exclusiveMinimum":0,"maximum":48}},"required":["confirm"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"find_customer","title":"Find customer","description":"Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"name":{"description":"Customer name substring to search (case-insensitive).","type":"string"},"phone":{"description":"Customer phone number or partial number to search.","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"upsert_customer","title":"Upsert customer","description":"[demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"customerId":{"description":"When provided, updates the customer with this id.","type":"string"},"name":{"description":"Customer display name.","type":"string"},"phone":{"description":"Customer phone number.","type":"string"},"email":{"description":"Customer email address (optional).","type":"string"},"address":{"description":"Customer street address (optional).","type":"string"},"postalCode":{"description":"Customer postal code (optional).","type":"string"},"city":{"description":"Customer city or locality (optional).","type":"string"}}},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"delete_customer","title":"Delete customer","description":"[demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"customerId":{"type":"string","minLength":1,"description":"ID of the customer to delete."}},"required":["customerId"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"quote_shipping","title":"Quote shipping","description":"Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"originPostalCode":{"type":"string","description":"Origin postal code (4 digits)."},"destinationPostalCode":{"type":"string","description":"Destination postal code (4 digits)."},"weightGrams":{"type":"number","exclusiveMinimum":0,"description":"Total shipment weight in grams."},"declaredValue":{"description":"Declared value in ARS for insurance.","type":"number","minimum":0}},"required":["originPostalCode","destinationPostalCode","weightGrams"]},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true}},{"name":"create_shipment","title":"Create shipment","description":"[demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"provider":{"type":"string","description":"Courier slug from quote_shipping ('andreani', 'oca')."},"saleId":{"type":"string","description":"Velora Sale ID."},"customerName":{"type":"string","description":"Recipient first name."},"customerLastName":{"description":"Recipient last name (optional).","type":"string"},"customerAddress":{"type":"string","description":"Recipient street name."},"customerAddressNumber":{"description":"Recipient street number (required by OCA).","type":"string"},"customerPostalCode":{"type":"string","description":"Recipient postal code."},"customerCity":{"description":"Recipient city (optional).","type":"string"},"customerProvince":{"description":"Recipient province (required by OCA).","type":"string"},"customerPhone":{"description":"Recipient phone number (optional).","type":"string"},"customerDni":{"description":"Recipient DNI (required by Andreani in production).","type":"string"},"service":{"description":"Courier-specific service key (defaults to 'domicilio').","type":"string"},"weightGrams":{"type":"number","exclusiveMinimum":0,"description":"Total shipment weight in grams."}},"required":["provider","saleId","customerName","customerAddress","customerPostalCode","weightGrams"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":true}},{"name":"track_shipment","title":"Track shipment","description":"Tracks the current status and event history of a shipment by tracking number.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"trackingNumber":{"type":"string","description":"Tracking number returned by the courier at shipment creation time."},"provider":{"type":"string","description":"Courier that created the shipment ('andreani', 'oca')."}},"required":["trackingNumber","provider"]},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true}},{"name":"get_package_profile","title":"Get package profile","description":"Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"saleId":{"description":"Velora Sale ID (takes priority over productIds).","type":"string"},"productIds":{"description":"Array of Velora Product IDs (assumes qty=1 per id).","type":"array","items":{"type":"string"}},"weightGramsOverride":{"description":"Explicit weight override in grams.","type":"number","exclusiveMinimum":0}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"send_whatsapp_text","title":"Send WhatsApp text","description":"[demo: deshabilitada] Sends a plain-text WhatsApp message to a customer phone number. Only valid inside the 24-hour customer-service window (Meta error 131026 outside).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"to":{"type":"string","minLength":1,"description":"Recipient phone number (local AR or E.164)."},"text":{"type":"string","minLength":1,"description":"Message text body."},"mediaUrl":{"description":"Optional public URL of a media file to attach.","type":"string","format":"uri"}},"required":["to","text"]},"annotations":{"readOnlyHint":false,"idempotentHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"send_whatsapp_template","title":"Send WhatsApp template","description":"[demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"to":{"type":"string","minLength":1,"description":"Recipient phone number (local AR or E.164)."},"templateName":{"type":"string","description":"Exact template name as registered in Meta Business Manager."},"components":{"description":"Template variable substitutions (omit for templates with no placeholders).","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["body","header","button"],"description":"Component section to populate."},"parameters":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"]},"description":"Ordered text substitutions."}},"required":["type","parameters"]}},"languageCode":{"description":"BCP-47 language code (defaults to 'es_AR').","type":"string"}},"required":["to","templateName"]},"annotations":{"readOnlyHint":false,"idempotentHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"connection_status","title":"Connection status","description":"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.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"caja_consultar_saldo","title":"Consult cash balance","description":"Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"caja_ciclo_caja","title":"Open or close cash shift","description":"[demo: deshabilitada] Opens or closes a cash register shift for the authenticated business.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"action":{"type":"string","enum":["abrir","cerrar"],"description":"'abrir' to open a shift, 'cerrar' to close it."},"monto":{"type":"number","minimum":0,"description":"Opening float (abrir) or physically counted cash (cerrar) in ARS."},"nota":{"description":"Optional operator note.","type":"string","maxLength":500}},"required":["action","monto"]},"annotations":{"readOnlyHint":false,"idempotentHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"caja_registrar_movimiento","title":"Register cash movement (caja)","description":"[demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"tipo":{"type":"string","enum":["ingreso","gasto","retiro","sangria","sangría","impuesto","sueldo"],"description":"Movement type."},"monto":{"type":"number","exclusiveMinimum":0,"description":"Positive amount in ARS."},"descripcion":{"type":"string","minLength":1,"maxLength":500,"description":"Movement description."}},"required":["tipo","monto","descripcion"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"get_payment_intent_status","title":"Get payment intent status","description":"Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"paymentIntentId":{"description":"Velora PaymentIntent id. Optional when customerName is provided.","type":"string"},"customerName":{"description":"Customer name (fuzzy match).","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":true}},{"name":"open_payment_link_wizard","title":"Open payment link wizard","description":"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).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"description":{"type":"string","minLength":1,"description":"Cobro description (e.g. '3 alfajores')."},"customerId":{"description":"Customer ID (optional).","type":"string","minLength":1},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"description":"Product ID."},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Units."},"unitPriceOverride":{"description":"Optional negotiated unit price.","type":"number","exclusiveMinimum":0}},"required":["productId","quantity"]},"description":"Line items (productId + quantity)."}},"required":["description","items"]},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"open_pending_orders","title":"Open pending orders","description":"Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"open_cobro_status","title":"Open cobro status","description":"Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"paymentIntentId":{"description":"Velora PaymentIntent id (optional when customerName is provided).","type":"string"},"customerName":{"description":"Customer name (optional when paymentIntentId is provided).","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"open_delivery_receipt","title":"Open delivery receipt","description":"Opens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"paymentIntentId":{"description":"Velora PaymentIntent id (optional).","type":"string"},"saleId":{"description":"Velora Sale id (optional).","type":"string"},"customerName":{"description":"Customer name (optional).","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"create_tracked_payment_link","title":"Create tracked payment link","description":"[demo: deshabilitada] Creates a tracked MercadoPago payment link for a catalog-tied cobro: atomically records the Sale + Invoice + PaymentIntent, then generates a real Checkout Pro link. MONEY: real and irreversible.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"customerId":{"type":"string","minLength":1,"description":"Customer ID."},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"description":"Product ID."},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Units."},"unitPriceOverride":{"description":"Optional negotiated unit price.","type":"number","exclusiveMinimum":0}},"required":["productId","quantity"]},"description":"Line items."},"description":{"type":"string","minLength":1,"description":"Cobro description shown on the MP preference."},"expiresInDays":{"description":"Link lifetime in days (1–30, default 3).","type":"integer","minimum":1,"maximum":30},"idempotencyKey":{"type":"string","minLength":1,"description":"Stable UUID generated by the wizard."}},"required":["customerId","items","description","idempotencyKey"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":true}},{"name":"list_suppliers","title":"List suppliers","description":"Returns all suppliers for this business (up to 50, sorted by name).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"search":{"description":"Optional name substring to filter suppliers.","type":"string"}}},"annotations":{"readOnlyHint":true,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"create_supplier","title":"Create supplier","description":"[demo: deshabilitada] Creates a supplier for this business.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"name":{"type":"string","minLength":1,"description":"Supplier name (must be unique within this business)."},"phone":{"description":"Supplier phone number (optional).","type":"string"},"email":{"description":"Supplier email address (optional).","type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"contactName":{"description":"Contact person name (optional).","type":"string"},"leadTimeDays":{"description":"Default lead time in days (optional).","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["name"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"create_purchase_request","title":"Create purchase request","description":"[demo: deshabilitada] Creates a procurement order (purchase request) to a supplier.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"supplierId":{"description":"Existing supplier ID (optional if supplierName is provided).","type":"string"},"supplierName":{"description":"Supplier name (optional if supplierId is provided).","type":"string"},"itemName":{"type":"string","minLength":1,"description":"Name of the item being ordered."},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"Quantity to order."},"unitPrice":{"type":"number","minimum":0,"description":"Unit price per item in ARS."}},"required":["itemName","quantity","unitPrice"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"edit_supplier","title":"Edit supplier","description":"[demo: deshabilitada] Updates an existing supplier's fields.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"supplierId":{"type":"string","minLength":1,"description":"ID of the supplier to update."},"name":{"description":"New supplier name (optional).","type":"string","minLength":1},"phone":{"description":"New phone number, or null to clear.","anyOf":[{"type":"string"},{"type":"null"}]},"email":{"description":"New email, or null to clear.","anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"contactName":{"description":"New contact person name, or null to clear.","anyOf":[{"type":"string"},{"type":"null"}]},"leadTimeDays":{"description":"New lead time in days, or null to clear.","anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["supplierId"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"delete_supplier","title":"Delete supplier","description":"[demo: deshabilitada] Deletes a supplier from this business (with full audit trail).","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"supplierId":{"type":"string","minLength":1,"description":"ID of the supplier to delete."}},"required":["supplierId"]},"annotations":{"readOnlyHint":false,"idempotentHint":true,"destructiveHint":true,"openWorldHint":false}},{"name":"query_sales","title":"Query sales","description":"Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"metrica":{"type":"string","enum":["ventas_periodo","margen","ranking_productos","por_empleado","historial_cliente"],"description":"Metric to query."},"preset":{"description":"Preset date range. Mutually exclus

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://artifacts.apis.io/somosvelora-com/json-schema/velora-mcp-tools.json