Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
| Endpoint | https://tools.somosvelora.com/api/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.1 |
| Now | 50 tools · grade C (65) · pin ts_526eee759aa28ed21af6432c64e464dd · protocol 2025-06-18 |
| First / last listed | 2026-11-07 02:02 UTC / 2026-11-07 02:02 UTC |
| Grade over time | 2026-11-07: C (65), 50 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: validate_cuit get_fiscal_readiness emit_invoice emit_nota create_product edit_product stock_load adjust_stock delete_product bulk_price_update query_catalog open_catalog_selector register_sale register_movement return_sale find_customer upsert_customer delete_customer quote_shipping create_shipment track_shipment get_package_profile send_whatsapp_text send_whatsapp_template connection_status caja_consultar_saldo caja_ciclo_caja caja_registrar_movimiento get_payment_intent_status open_payment_link_wizard open_pending_orders open_cobro_status open_delivery_receipt create_tracked_payment_link list_suppliers create_supplier create_purchase_request edit_supplier delete_supplier query_sales connect_mercadopago connect_pedidosya connect_whatsapp connect_tiendanube upload_catalog open_sale_confirm open_caja_status open_onboarding open_business_overview open_shipment_prep
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. params: cuit* |
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. params: none |
emit_invoice | [demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code. params: customerCuit*, amountARS*, tipo*, concept, requestId |
emit_nota | [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. params: customerCuit*, amountARS*, tipo*, kind*, associatedInvoice*, concept, requestId |
create_product | [demo: deshabilitada] Creates a new product in the business catalog. Requires name and price. params: name*, price*, costPrice, weightGrams, initialStock |
edit_product | [demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity). params: productId*, name, price, costPrice, stockQuantity |
stock_load | [demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail. params: productId, itemName*, supplierId, supplierName, quantity*, unitPrice, autoCreateProduct, createPurchaseRequest |
adjust_stock | [demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail). params: productId*, mode*, quantity* |
delete_product | [demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog. params: productId* |
bulk_price_update | [demo: deshabilitada] Mass price change for all products or a specified subset in this business. params: amount*, mode*, direction*, productIds |
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. params: search |
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). params: search |
register_sale | [demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice. params: items*, customerId, paymentMethod, requestId |
register_movement | [demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment'). params: type*, description*, amount*, date |
return_sale | [demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible. params: confirm*, count, cutoffHours |
find_customer | Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name. params: name, phone |
upsert_customer | [demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business. params: customerId, name, phone, email, address, postalCode, city |
delete_customer | [demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices). params: customerId* |
quote_shipping | Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending. params: originPostalCode*, destinationPostalCode*, weightGrams*, declaredValue |
create_shipment | [demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL. params: provider*, saleId*, customerName*, customerLastName, customerAddress*, customerAddressNumber, customerPostalCode*, customerCity, customerProvince, customerPhone, customerDni, service, weightGrams* |
track_shipment | Tracks the current status and event history of a shipment by tracking number. params: trackingNumber*, provider* |
get_package_profile | Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride. params: saleId, productIds, weightGramsOverride |
send_whatsapp_text | [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). params: to*, text*, mediaUrl |
send_whatsapp_template | [demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window. params: to*, templateName*, components, languageCode |
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. params: none |
caja_consultar_saldo | Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only. params: none |
caja_ciclo_caja | [demo: deshabilitada] Opens or closes a cash register shift for the authenticated business. params: action*, monto*, nota |
caja_registrar_movimiento | [demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll. params: tipo*, monto*, descripcion* |
get_payment_intent_status | Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name. params: paymentIntentId, customerName |
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). params: description*, customerId, items* |
open_pending_orders | Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free. params: none |
open_cobro_status | Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName. params: paymentIntentId, 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. params: paymentIntentId, saleId, customerName |
create_tracked_payment_link | [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. params: customerId*, items*, description*, expiresInDays, idempotencyKey* |
list_suppliers | Returns all suppliers for this business (up to 50, sorted by name). params: search |
create_supplier | [demo: deshabilitada] Creates a supplier for this business. params: name*, phone, email, contactName, leadTimeDays |
create_purchase_request | [demo: deshabilitada] Creates a procurement order (purchase request) to a supplier. params: supplierId, supplierName, itemName*, quantity*, unitPrice* |
edit_supplier | [demo: deshabilitada] Updates an existing supplier's fields. params: supplierId*, name, phone, email, contactName, leadTimeDays |
delete_supplier | [demo: deshabilitada] Deletes a supplier from this business (with full audit trail). params: supplierId* |
query_sales | Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'. params: metrica*, preset, from, to, customer_name, limit |
connect_mercadopago | [demo: deshabilitada] Connects MercadoPago for this business using the BYOA OAuth-redirect model. Primary: returns an authorization URL. Fallback: accepts a production access token directly. params: accessToken |
connect_pedidosya | [demo: deshabilitada] Connects PedidosYa for this business using the BYOA secure-form model. Primary: returns a secure link. Fallback: accepts an API token directly. params: apiToken |
connect_whatsapp | [demo: deshabilitada] Connects WhatsApp Business using the BYOA Meta Embedded Signup model. Primary: returns a signup link. Optional: registers a phone number as a lightweight pre-step. params: phone |
connect_tiendanube | [demo: deshabilitada] Connects Tienda Nube (Nuvemshop) using the BYOA OAuth-redirect model. Returns an authorization URL — no token ever passes through chat. Gated behind env config in production. params: none |
upload_catalog | [demo: deshabilitada] Bulk-creates products in the business catalog from a structured list (up to 50 items). params: products* |
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. params: items*, customerId |
open_caja_status | Opens a visual widget showing the current shift state and action buttons. Read-only here. params: none |
open_onboarding | Opens a graphical onboarding hub showing integration status and connect links. Read-only. params: none |
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. params: customerName, defaultTab |
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. params: items*, originPostalCode*, destinationPostalCode*, declaredValue |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.